home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr25 / os2you27.zip / OS2YOU.INF (.txt) < prev    next >
OS/2 Help File  |  1993-03-19  |  71KB  |  2,209 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Why you should register this product ΓòÉΓòÉΓòÉ
  3.  
  4. Why you should register this product 
  5.  
  6.  This program is released as shareware. This means that you have the software 
  7. for a trial period, and after a reasonable evaluation time, you register the 
  8. product by paying a fee to the author, if you find the program of use.  Some 
  9. limitations on how you can use this program exists (see the section Important 
  10. license information for more about this).  By registering this product you 
  11. support the further development of this program.
  12.  
  13.  You will get the following benefits if you register: 
  14.  
  15.  o You will get the most recent versions of Os2You and M2Zmodem. 
  16.  
  17.  o You will get rid of the introduction screen with the delay, when logging on 
  18.    to the host. 
  19.  
  20.  o You will get a Presentation Manager terminal program specially written to 
  21.    work with Os2You, with both asynchronous devices and named pipes. Automatic 
  22.    dial, logon to host, file transfer and some other goodies. 
  23.  
  24.  o You will get a utility making it possible for Os2You to use baudrates as 
  25.    high as 38400, 57600 or 115200 bauds, using the standard communication 
  26.    device drivers included with OS/2. 
  27.  
  28.  o You will be sleeping good tonight, without any bad conscience haunting 
  29.    you... 
  30.  
  31.  
  32. ΓòÉΓòÉΓòÉ 2. Introduction ΓòÉΓòÉΓòÉ
  33.  
  34. Introduction 
  35.  
  36.  Os2You is a communication software allowing remote operation of any OS/2 full 
  37. screen text session or DOS full screen text session, over an asynchronous line 
  38. (by cable or modem), a pipe or a remote pipe (over a LAN).  The program can be 
  39. used with many different terminals and allows high speed file transfers between 
  40. host and remote.  The program may be used in two different ways.  You can run 
  41. the program as it is stand alone, but it is also possible to call the program 
  42. from your own program, allowing your own programs to offer remote operation. 
  43.  
  44. Some different ideas on how to use Os2You: 
  45.  
  46.  o Installed on your office PC, it is possible to run the PC and access the 
  47.    files from your home using a PC, LapTop or even a simple terminal. 
  48.  
  49.  o Installed in a BBS, it is possible to run most character based programs 
  50.    on-line in the BBS (like on-line games), or run maintenance programs. 
  51.  
  52.  o Installed in a LAN, it is possible to run programs on different machines on 
  53.    the network. This makes it possible for DOS requesters to run OS/2 character 
  54.    applications without installing OS/2 on them. 
  55.  
  56.  o Installed in a LAN, it is possible to access asynchronous ports for outgoing 
  57.    traffic both from OS/2 and DOS requesters, using included programs, or any 
  58.    character based OS/2 communication package. 
  59.  
  60.  o Installed on your customers systems, it makes it easy for you to service 
  61.    these by running their system on-line. 
  62.  
  63.  o You could turn your OS/2 machine into a multi-user system, except that you 
  64.    might miss some security control, normally available on multi-user systems. 
  65.  
  66.  The program can directly replace the program MaxPipe (from Peter Fitzsimmons), 
  67.  and will be compatible with more programs than MaxPipe. 
  68.  
  69.  The program is only tested with OS/2 1.3 and OS/2 2.0, but should work OK with 
  70.  OS/2 1.2.  It does NOT work with OS/2 1.0. 
  71.  
  72.  If you have got the distribution files packed in a ZIP-file, you should unpack 
  73.  them first.  Files included in this package: 
  74.  
  75.  OS2YOU.EXE          The remote software 
  76.  
  77.  SETUP.EXE           Setup program for Os2You, invoked by Os2You 
  78.  
  79.  SETBAUD.EXE         Program used by Os2You.  (only to registered users). 
  80.  
  81.  LANTERM.EXE         Terminal program using DOS on a LAN or modem. 
  82.  
  83.  LANTERM2.EXE        Terminal program using OS/2 on a LAN or modem. 
  84.  
  85.  WINTERM.EXE         Terminal program using Windows 3.0 on a LAN or modem. 
  86.  
  87.  LANBRIDG.EXE        LAN Bridge, to access OS/2 Requesters remote over LAN 
  88.  
  89.  LANREL.EXE          Program to temporarily suspend Os2You to free port 
  90.  
  91.  TERM2.EXE           Terminal program using OS/2 PM on a LAN or modem (only to 
  92.                      registered users) 
  93.  
  94.  TERM2_V.EXE         Submodule for TERM2.  Required with TERM2 (only to 
  95.                      registered users) 
  96.  
  97.  DOS_SRV.EXE         Program to access DOS compatibility boxes in OS/2 2.0. 
  98.  
  99.  KBFILTER.COM        Resident program for the DOS-box, to use function keys 
  100.                      remote 
  101.  
  102.  ????????.PRM        Terminal description files for different terminals 
  103.  
  104.  MODEM.SET           Modem definitions 
  105.  
  106.  SZ.CMD              Command file to initiate Zmodem file transfer from host to 
  107.                      remote using M2Zmodem (not included). 
  108.  
  109.  RZ.CMD              Command file to initiate Zmodem file transfer from remote 
  110.                      to host using M2Zmodem (not included). 
  111.  
  112.  OS2YOU.INF          This documentation 
  113.  
  114.  ORDER.DOC           Printable Order/Invoice form 
  115.  
  116.  If you don't think this is the most current version of Os2You, you could send 
  117.  a formatted diskette and four International Post reply coupons (Coupon-R╨Æponse 
  118.  International, Union Postale Universelle) to my address mentioned last in this 
  119.  documentation. 
  120.  
  121.  
  122. ΓòÉΓòÉΓòÉ 3. Stand alone installation ΓòÉΓòÉΓòÉ
  123.  
  124. Stand alone installation 
  125.  
  126.  You should copy all distributed files should be copied to a subdirectory on 
  127. your hard disk.  Before running Os2You, you must make that subdirectory the 
  128. current directory (Working Directory).  Assuming you have copied the files to 
  129. subdirectory called C:\Remote this is done by the command:
  130.  
  131.  CD \Remote
  132.  
  133.  To configure the program in stand alone mode, you run the program OS2YOU from 
  134. an OS/2 Command Prompt, without any parameters. Os2You will load a 
  135. configuration utility running with Presentation Manager.  Note, that you should 
  136. always start Os2You in a full screen session.
  137.  
  138.  The CONFIG.SYS file should be altered to include the following lines: 
  139.  
  140.  IOPL=YES                                (if you plan to use baudrates higher 
  141.                                          than 19200 bauds or DOS support) 
  142.  
  143.  DEVICE=C:\OS2\COM01.SYS                 (if you have an AT class machine and 
  144.                                          use serial line) 
  145.  
  146.  DEVICE=C:\OS2\COM02.SYS                 (if you have an MCA class machine and 
  147.                                          use serial line) 
  148.  
  149.  DEVICE=C:\OS2\COM.SYS                   (if you have OS/2 2.0 and use serial 
  150.                                          line) 
  151.  
  152.  AUTOFAIL=YES                            To avoid pop-up error messages 
  153.  
  154.  To start the program with an existing configuration file, you start the 
  155.  program by typing Os2You -c <cfg-file> at the OS/2 Command Prompt (you replace 
  156.  <cfg-file> with the configuration filename you want to use, like Os2You.CFG). 
  157.  For more command line start options see separate section below or enter Os2You 
  158.  -? at the prompt.
  159.  
  160.   The program will now put the modem into auto answer mode (if your modem is 
  161.  supported by the program), and wait for an incoming call, and answer it.  When 
  162.  the connection is established, the caller will be asked for an ID and password 
  163.  and validate them with your configuration file.
  164.  
  165.   If you have specified a callback number for the caller, the connection will 
  166.  be closed, and the Os2You program will call the phone number in the userlist 
  167.  entry (note that you should only include the phone number in the user list 
  168.  entry and not the Hayes command prefix ATD, but if you want, it is possible to 
  169.  include any dialling command in the entry).  The caller will be asked for the 
  170.  password once again, and will then be spawned to an OS/2 full screen text 
  171.  session. 
  172.  
  173.  
  174. ΓòÉΓòÉΓòÉ 4. What is a named pipe? ΓòÉΓòÉΓòÉ
  175.  
  176. What is a named pipe?
  177.  
  178.  The Named pipe specification is a powerful high level communication interface, 
  179. for communication between two programs.  Program using named pipes can 
  180. communicate with one another locally, or they can have their requests 
  181. redirected across a network.  The transport media is not significant for the 
  182. programs using the named pipe specification.  A program working locally on an 
  183. OS/2 machine should work equally well across a LAN or a dial up link, as long 
  184. as the transport media supports named pipes.  IBM Lan Server, Microsoft Lan 
  185. Manager and Novell Netware are different LANs supporting named pipes.
  186.  
  187.  In addition to being independent of the transport media, the named pipe 
  188. specification is working across different hardware and operating system platforms.
  189.  
  190.  
  191. ΓòÉΓòÉΓòÉ 5. Using Os2You with pipes or remote pipes with a LAN ΓòÉΓòÉΓòÉ
  192.  
  193. Using Os2You with pipes or remote pipes with a LAN 
  194.  
  195.  It is possible to use Os2You in a Local Area Network (LAN) environment, by 
  196. using Named Pipes.  Os2You should run on any network compatible with the Named 
  197. Pipe interface, like Microsoft Lan Manager, IBM Lan Server and Novell Netware. 
  198. By installing Os2You in a LAN, you can access an OS/2 machine remote from a 
  199. workstation connected to the LAN.
  200.  
  201.  You will use the program LanTerm or WinTerm if you want to access the remote 
  202. machine from a DOS workstation, LanTerm2 or Terminal/2 if you will access the 
  203. remote machine from an OS/2 workstation.  LanTerm (for DOS) can be installed as 
  204. a Terminate and Stay Resident (TSR) program, allowing you to switch between the 
  205. remote OS/2 session and the local DOS session.  LanTerm(2) will terminate when 
  206. you logout from the remote session, or if you press Ctrl-Break.  If you 
  207. terminate the programs during a remote session, the remote session will be 
  208. closed, and Os2You will wait for another logon.  The LanTerm (for DOS) program, 
  209. requires that ANSI.SYS is loaded in your CONFIG.SYS file (on the DOS machine).
  210.  
  211.  If you want to use Os2You in a LAN on a machine supporting Named Pipe Server 
  212. applications, you should configure Os2You for stand alone mode, but select a 
  213. named pipe as your communications device instead, like \Pipe\Os2You as 
  214. communications device.  Assuming you have installed Os2You on a machine called 
  215. MyComputer, you access Os2You from a remote workstation on the LAN by starting 
  216. the LanTerm(2) program like this:
  217.  
  218.  LanTerm \\MyComputer\Pipe\Os2You
  219.  
  220.  If you want to use Os2You in LAN on a machine that only supports Named Pipe 
  221. Requester applications, you will have to install a program called LanBridg on 
  222. any other OS/2 machine on the network supporting Named Pipe Server 
  223. applications.  You install LanBridg on the Named Pipe Server machine, like this:
  224.  
  225.  LanBridg \Pipe\Os2You \Pipe\LanTerm
  226.  
  227.  On the OS/2 machine you want to run remote, you install Os2You for stand alone 
  228. mode, by select a named pipe as your communications device instead.  Assuming 
  229. you have installed LanBridg on a machine called MyServer, you should install 
  230. Os2You to use the pipe name \\MyServer\Pipe\Os2You as your communications 
  231. device.  To access the machine from a remote machine on the LAN, you start the 
  232. LanTerm(2) program like this:
  233.  
  234.  LanTerm \\MyServer\Pipe\LanTerm
  235.  
  236.  It is possible to start multiple sessions with Os2You using the same Pipe 
  237. name.  Each running copy of Os2You will be ready to receive a connect request 
  238. from a remote user, and the user will be connected to the first free instance 
  239. of Os2You.
  240.  
  241.  Note, that early versions of IBM LAN Server did not work properly with remote 
  242. named pipes, especially not from DOS Requesters.  This software is tested with 
  243. OS/2 Lan Server 1.2 CSD 4093, and worked on this configuration both from OS/2 
  244. requesters and DOS requesters.  But when tested with CSD 4063 the program did 
  245. not work with DOS Requesters, but was OK with OS/2 Requesters.
  246.  
  247.  This is a chart of how Os2You and LanTerm is configured to work together: 
  248.  
  249. ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù         ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù
  250. Γòæ OS/2 Async. Host      Γòæ         Γòæ DOS Remote (terminal)        Γòæ
  251. ΓòƒΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓò½ΓöÇmodemsΓöÇΓöÇΓò½ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓòó
  252. Γòæ Os2You <- <comport>...Γòæ    Γöé    Γòæ LanTerm <comport> <baudrate> Γòæ
  253. ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥    Γöé    ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥
  254.                              Γöé    ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù
  255.                              Γöé    Γòæ OS/2 Remote (terminal)       Γòæ
  256.                              ΓööΓöÇΓöÇΓöÇΓöÇΓò½ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓòó
  257.                                   Γòæ LanTerm2 <comport> <baudrate>Γòæ
  258.                                   ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥
  259.  
  260.  
  261. ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù      ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù
  262. Γòæ LAN Server (host)     Γòæ      Γòæ DOS Requester (terminal)      Γòæ
  263. ΓòƒΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓò½ΓöÇLANΓöÇΓöÇΓò½ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓòó
  264. Γòæ Os2You <- \Pipe\Os2YouΓòæ  Γöé   Γòæ LanTerm \\Srvname\Pipe\Os2You Γòæ
  265. ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥  Γöé   ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥
  266.                            Γöé   ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù
  267.                            Γöé   Γòæ OS/2 Requester (terminal)     Γòæ
  268.                            ΓööΓöÇΓöÇΓöÇΓò½ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓòó
  269.                                Γòæ LanTerm2 \\Srvname\Pipe\Os2YouΓòæ
  270.                                ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥
  271.  
  272.  
  273. ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù
  274. Γòæ OS/2 Requester (host)            Γòæ
  275. ΓòƒΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓòó
  276. Γòæ Os2You <- \\Srvname\Pipe\Os2You  Γòæ
  277. ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòñΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥
  278.                Γöé
  279.                Γöé
  280. ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòºΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù     ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù
  281. Γòæ LAN Server (bridge)       Γòæ     Γòæ DOS Requester (terminal)       Γòæ
  282. ΓòƒΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓò½ΓöÇLANΓöÇΓò½ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓòó
  283. Γòæ LanBridg                  Γòæ  Γöé  Γòæ LanTerm \\Srvname\Pipe\Lanterm Γòæ
  284. Γòæ \Pipe\Os2You \Pipe\LanTermΓòæ  Γöé  ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥
  285. ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥  Γöé  ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù
  286.                                Γöé  Γòæ OS/2 Requester (terminal)      Γòæ
  287.                                ΓööΓöÇΓöÇΓò½ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓòó
  288.                                   Γòæ LanTerm2 \\Srvname\Pipe\LanTermΓòæ
  289.                                   ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥
  290.  
  291.  
  292. ΓòÉΓòÉΓòÉ 6. Using the configuration utility ΓòÉΓòÉΓòÉ
  293.  
  294. Using the configuration utility 
  295.  
  296.  If you start Os2You without any parameters, or run the program Setup the 
  297. configuration utility will be loaded.  This is a Presentation Manager program 
  298. with pull down menus.  Each section under this header, describes a 
  299. corresponding pull down menu.
  300.  
  301.  By clicking on the plus sign on the left of this item in the main menu, you 
  302. will get help on the different steps in the setup utility. 
  303.  
  304.  
  305. ΓòÉΓòÉΓòÉ 6.1. Device configuration ΓòÉΓòÉΓòÉ
  306.  
  307. Device configuration 
  308.  
  309.  This choice gives you a dialog panel to configure the communications device 
  310. you want to use.  Parameters in this panel are: 
  311.  
  312.  Device         This parameter specifies which communication device Os2You 
  313.                 should use.  You may select an asynchronous device or a named 
  314.                 pipe. Remote named pipes (between different computers in a 
  315.                 network) have the syntax \\ComputerName\Pipe\AnyName
  316.  
  317.                  By clicking on the down array to the right, you will get some 
  318.                 pre-defined devices commonly used. 
  319.  
  320.  Modem          This parameter specifies what modem you have connected to the 
  321.                 device.  The currently selected modem is displayed in this 
  322.                 field.  By clicking on the down array to the right, you will 
  323.                 get a list with the modem configurations available.
  324.  
  325.                  You should select the first entry Pipe connection, if you are 
  326.                 communicating via a named pipe.
  327.  
  328.                  If you are communicating via a cable connection (null modem) 
  329.                 or a manual modem, you should select Cable connection in the 
  330.                 list, and alter the definition to suit your needs.
  331.  
  332.                  To alter the modem configurations, you should select Modem 
  333.                 from the action bar. 
  334.  
  335.  Databits       This parameter specifies how many databits Os2You should use 
  336.                 for the communication device.  Usually you should select 8 or 
  337.                 7. This option is only significant if you use an asynchronous 
  338.                 device. 
  339.  
  340.  Stopbits       This parameter specifies how many stopbits Os2You should use. 
  341.                 Usually you should select 1 stop bit.  This option is only 
  342.                 valid if you use an asynchronous device. 
  343.  
  344.  Parity         This parameter specifies which parity to use. Usually you 
  345.                 should for 8 data bits) or EVEN (for 7 data bits). This option 
  346.                 is only valid for asynchronous devices. 
  347.  
  348.  FIFO buffer    This option specifies if Os2You should use the enhanced 
  349.                 buffering capabilities (if available) in some asynchronous 
  350.                 devices. This option should be set to enabled except for some 
  351.                 rare situations. 
  352.  
  353.  
  354. ΓòÉΓòÉΓòÉ 6.2. Special settings ΓòÉΓòÉΓòÉ
  355.  
  356. Special settings 
  357.  
  358.  This choice give you a dialog panel to configure some settings on how Os2You 
  359. should work.  Parameters in this panel are: 
  360.  
  361.  Inactivity timeout       This parameter specifies for how long a user can be 
  362.                           inactive (not using the keyboard) before he is 
  363.                           automaticly logged off. 
  364.  
  365.  Screen update delay      This parameter specified how often the remote display 
  366.                           will be updated.  Between each screen update, Os2You 
  367.                           waits for some time, before it updates the screen 
  368.                           again.  This delay is typically set to 100 ms, but 
  369.                           could be lowered to enhance the response time, or 
  370.                           higher to minimize the overhead caused by Os2You. 
  371.  
  372.  Cursor update delay      When accessing sessions via the task switcher, the 
  373.                           cursor position updates must be done in a special 
  374.                           way, that cause screen flicker on the Os2You host 
  375.                           machine.  This parameter specifies how often the 
  376.                           cursor position will be updated on the remote screen. 
  377.                           If set to 0 (zero) cursor position updates will be 
  378.                           disabled.  This parameter does not affect cursor 
  379.                           updates for sessions started by Os2You. 
  380.  
  381.  Execution priority       This parameter specifies which priority the screen 
  382.                           update procedure should have.  The higher the 
  383.                           priority the more power the program has to fulfill 
  384.                           its task.  But if the priority is set too high, other 
  385.                           programs don't get any power to execute at all 
  386.                           (including the one you will execute remote).  This 
  387.                           parameter is usually set to NORMAL/4, and should be 
  388.                           altered only if you experience severe performance 
  389.                           problems. 
  390.  
  391.  Detect carrier loss      This parameter specifies if loss of carrier should 
  392.                           cause an automatic logoff.  When two modems are 
  393.                           connected, there is a signal present called carrier, 
  394.                           to show this.  If the carrier suddenly disappears, 
  395.                           this means the connection was lost.  To prevent 
  396.                           anyone else to connect to the computer, it is 
  397.                           possible to logoff the user if this case happens. 
  398.                           This option is only valid for asynchronous devices. 
  399.  
  400.  Lock configuration file  This option tells if Os2You should lock the 
  401.                           configuration/login file, to prevent a logged on 
  402.                           user, to read or alter the configuration or other 
  403.                           users passwords. If set, it is im possible to read or 
  404.                           alter the configuration/login file while a user is 
  405.                           logged on. 
  406.  
  407.  Printer port             This parameter specifies which device Os2You should 
  408.                           redirect to the remote printer. 
  409.  
  410.  Printer redirection      This parameter specifies how printer redirection will 
  411.                           work.  If you select Local no redirection will take 
  412.                           place, and printer output will go to the host 
  413.                           printer.  If you select Remote printer output will be 
  414.                           redirected to the remote printer.  If you select Both 
  415.                           printer output will be redirected to the remote 
  416.                           printer, but also sent to the local (host) printer. 
  417.  
  418.  Port request pipe        This option specified which pipe name to use for port 
  419.                           requests.  It is possible to request Os2You to 
  420.                           temporarily release the asynchronous port, while the 
  421.                           program is waiting for an incoming call, to allow 
  422.                           other communication tasks to use the port.  These 
  423.                           requests are sent via this pipe.  If you leave this 
  424.                           entry empty the function will be disabled.  Named 
  425.                           pipes have the syntax \Pipe\Request 
  426.  
  427.  Show file at login       This parameter specifies which file to display as 
  428.                           information before a user logs in.  This could be a 
  429.                           logo or a help text for example.  The file may 
  430.                           contain any character, including control characters 
  431.                           and escape sequences.  If you leave this entry empty, 
  432.                           or the file does not exists, no file will be 
  433.                           displayed. 
  434.  
  435.  Log file                 This parameter specifies which file to log messages 
  436.                           in.  In the log file Os2You stores information about 
  437.                           the logon progress.  If you leave this entry empty, 
  438.                           no logging will take place. 
  439.  
  440.  
  441. ΓòÉΓòÉΓòÉ 6.3. Modem configuration ΓòÉΓòÉΓòÉ
  442.  
  443. Modem configuration 
  444.  
  445.  This choice will give you a list with modem definitions.  The two first 
  446. entries are reserved for special purpose.  The first entry Pipe connection, 
  447. should be used if you are communicating via a named pipe.
  448.  
  449.  If you are communicating via a cable connection (null modem) or a manual modem 
  450. the Cable connection definition should be used, and be altered to suit your 
  451. needs.  The only valid entries in this configuration panel are the Baudrates 
  452. and handshaking parameters.  These entries specify which baudrates you want to 
  453. use over the cable, and what kind of handshaking to use.  Se below for more 
  454. specific information about the next panel.
  455.  
  456.  If you are communicating via an automatic modem, like a Hayes compatible 
  457. modem, you should select one of the listed modems, best matching your modem.
  458.  
  459.  You can add, change, copy or delete modem definitions.  If you select add, 
  460. change or copy, you will get the modem configuration panel.  The modem 
  461. configuration panel has the following parameters: 
  462.  
  463.  Description                   A description of the modem type. 
  464.  
  465.  Initializing string           This parameter is sent to the modem each time 
  466.                                Os2You initializes the modem.  This command 
  467.                                should put the modem into auto answer mode. 
  468.                                Modem control characters may be used. 
  469.  
  470.  Dial command prefix           This parameter is sent by Os2You to dial a phone 
  471.                                number.  The dial command is composed by a lot 
  472.                                of different parameters.  This parameter is sent 
  473.                                first, to initialize the dial command. The phone 
  474.                                number is sent between the dial prefix and 
  475.                                suffix.  Modem control characters may be used. 
  476.  
  477.  Dial command suffix           This parameter is sent by Os2You to dial a phone 
  478.                                number.  The dial command is composed by a lot 
  479.                                of different parameters.  This parameter is sent 
  480.                                last, to finish the dial command.  The phone 
  481.                                number is sent between the dial prefix and 
  482.                                suffix.  Modem control characters may be used. 
  483.  
  484.  Turn off auto answer          This parameter is sent by Os2You to turn off 
  485.                                auto answer.  Modem control characters may be 
  486.                                used. 
  487.  
  488.  Hang up command               This parameter is sent by Os2You to hang up the 
  489.                                line and close the connection.  Modem control 
  490.                                characters may be used. 
  491.  
  492.  Shutdown string               This parameter is sent by Os2You before Os2You 
  493.                                is exiting.  Modem control characters may be 
  494.                                used. 
  495.  
  496.  Connect string 1-6            These strings are expected from the modem when 
  497.                                the modem has successfull established a 
  498.                                connection with another modem.  Os2You inspects 
  499.                                the result strings from the modem, and selects 
  500.                                the correct baudrate.  Os2You tries to match the 
  501.                                result strings from the modem with the connect 
  502.                                strings beginning with connect string 1 and 
  503.                                ending with string 6.  Therefore, if the result 
  504.                                strings are beginning equally, you should 
  505.                                specify the longer first.  A string like CONNECT 
  506.                                1200 should be specified before the connect 
  507.                                string CONNECT.  Os2You always initializes the 
  508.                                modem with the speed corresponding to connect 
  509.                                string 1. 
  510.  
  511.  Baudrate 1-6                  These values specifies which baudrates the 
  512.                                corresponding connect strings represent.  The 
  513.                                baudrate 1 is always used by Os2You to 
  514.                                initialize the modem. 
  515.  
  516.  CTS/RTS handshaking           This parameter specifies if hardware handshaking 
  517.                                using CTS/RTS should be used.  Sometimes the 
  518.                                computer can send away characters faster than 
  519.                                your modem manage to handle.  In this case the 
  520.                                modem uses handshaking signals to tell Os2You to 
  521.                                hold for some time.  If you have a modem with 
  522.                                higher rate between computer and modem, than 
  523.                                between the two connected modems, you may select 
  524.                                this option.  This parameter is only significant 
  525.                                if you use an asynchronous device. 
  526.  
  527.  Xon/Xoff handshaking          This parameter specifies if software handshaking 
  528.                                using Xon/Xoff should be used.  Sometimes the 
  529.                                computer can send away characters faster than 
  530.                                your modem manage to handle.  In this case the 
  531.                                modem uses handshaking signals to tell Os2You to 
  532.                                hold for some time. If you have a modem with 
  533.                                higher rate between computer and modem, than 
  534.                                between the two connected modems, you may select 
  535.                                this option.  This parameter is only significant 
  536.                                if you use an asynchronous device. 
  537.  
  538.  
  539. ΓòÉΓòÉΓòÉ 6.4. User table ΓòÉΓòÉΓòÉ
  540.  
  541. User table 
  542.  
  543.  This choice will give you a list with user profiles.  You can add, change, 
  544. copy or delete user definitions.  If you select add, change or copy, you will 
  545. get the user profile panel.  Note that no entries in the user profile should 
  546. ever contain the character ";" (semicolon)  The user profile panel has the 
  547. following parameters: 
  548.  
  549.  User name                This entry specifies the name of the user. This entry 
  550.                           is case insensitive, mikael and MIKAEL are treated 
  551.                           equally by Os2You. 
  552.  
  553.  User password            This entry specifies the password for the user. This 
  554.                           field may be left blank, in which case the user entry 
  555.                           isn't protected by password.  In this case any 
  556.                           password is accepted and the password is written to 
  557.                           the log file.  This field is case sensitive, secret 
  558.                           and SECRET are treated differently. 
  559.  
  560.  Callback number          This entry specifies the phone number for callback. 
  561.                           If you specify a callback number, Os2You will close 
  562.                           the connection after a successful logon, and call the 
  563.                           specified number and establish the connection once 
  564.                           again.  This enhance the safety in the system much, 
  565.                           and is also a way to get the phone bills on the other 
  566.                           account.  If you don't want callback operation, you 
  567.                           just leave this field empty.  Callback operation is 
  568.                           not possible on pipe or cable connections. 
  569.  
  570.  Shell command            This entry specifies which program to execute when 
  571.                           the user has logged on to the system.  This may be 
  572.                           any executable program which is compatible with 
  573.                           Os2You. Note that you should include the file 
  574.                           extension. This entry is typically set to CMD.EXE to 
  575.                           get an OS/2 command shell. Os2You can pass symbolic 
  576.                           parameters. 
  577.  
  578.  Startup session          This entry specifies what session to activate 
  579.                           initially when the user has logged in.  This entry 
  580.                           must exactly match (case sensitive) an entry in the 
  581.                           task list.  This can be both an OS/2 Full Screen 
  582.                           session or a DOS Full Screen session.  It is allowed 
  583.                           to specify a startup session, even if the user hasn't 
  584.                           access to the task switching normally.  In this case, 
  585.                           the user won't be able to alter task.  If this entry 
  586.                           is left blank the spawned session will be initially displayed.
  587.  
  588.  Allow taskswitching      This entry specifies if the user is allowed to switch 
  589.                           between different tasks, and access other tasks than 
  590.                           the one specified in the login table.  If the user is 
  591.                           not allowed to task switch some other functions in 
  592.                           Os2You are unavailable to the user of security 
  593.                           reasons (like the Ctrl-Break operation). 
  594.  
  595.  Terminal definition      This entry specifies which terminal definition to use 
  596.                           for the user.  The user should use a terminal 
  597.                           matching this definition.  If this field is left 
  598.                           empty, Os2You will use a built in ANSI terminal 
  599.                           protocol.  You may click at the arrow down on the 
  600.                           right, to get a list of available terminal 
  601.                           definitions. 
  602.  
  603.  
  604. ΓòÉΓòÉΓòÉ 6.5. Terminal definitions ΓòÉΓòÉΓòÉ
  605.  
  606. Terminal definitions 
  607.  
  608.  This choice will give you a list with terminal definitions.  You can add, 
  609. change, copy or delete terminal definitions.  If you select add, change or 
  610. copy, you will get the terminal definition panel. 
  611.  
  612.  Terminal file                 Name of the terminal definition.  It should have 
  613.                                the suffix PRM, and including the suffix, not be 
  614.                                longer than 12 characters. 
  615.  
  616.  Initializing                  This parameter is sent by Os2You to initialize 
  617.                                the terminal.  Normally no initializing is 
  618.                                required, in which case this field should be 
  619.                                left empty.  This entry expects an array of 
  620.                                hexadecimal digits. 
  621.  
  622.  Set cursor command            This parameter is sent by Os2You to position the 
  623.                                cursor.  The cursor position command is composed 
  624.                                by several different parameters.  This parameter 
  625.                                is sent first.  This entry expects an array of 
  626.                                hexadecimal digits. 
  627.  
  628.  Set cursor col ofs            This parameter specifies the offset for the 
  629.                                column value.  This parameter expects a decimal 
  630.                                constant.  The first column is zero. 
  631.  
  632.  Set cursor col first          This parameter specifies if the column or row 
  633.                                value should be sent first. 
  634.  
  635.  Set cursor separator          This parameter is sent between the row and 
  636.                                column values.  This entry expects an array of 
  637.                                hexadecimal digits. 
  638.  
  639.  Set cursor row ofs            This parameter specifies the offset for the row 
  640.                                value.  This parameter expects a decimal 
  641.                                constant.  The first row is zero. 
  642.  
  643.  Set cursor binary             This parameter specifies if the column and row 
  644.                                values should be sent as binary values or as 
  645.                                ASCII strings. 
  646.  
  647.  Set cursor terminator         This parameter is sent by Os2You to position the 
  648.                                cursor. The cursor position command is composed 
  649.                                by several different parameters.  This parameter 
  650.                                is sent last.  This entry expects an array of 
  651.                                hexadecimal digits. 
  652.  
  653.  Set cursor pad length         This parameter specifies how long each column 
  654.                                and row value should be if the Zero pad (see 
  655.                                below) parameter is set.  This parameter expects 
  656.                                a decimal constant. 
  657.  
  658.  Set cursor zero pad           This parameter specifies if the column and row 
  659.                                values should be justified with leading zeros to 
  660.                                fit the pad length. This parameter is not valid 
  661.                                if you have selected binary column and row 
  662.                                values. 
  663.  
  664.  Scroll up initializing        This parameter is sent by Os2You to scroll the 
  665.                                screen up.  The scroll command is composed by 
  666.                                two different parameters.  This parameter is 
  667.                                sent first, before any scrolling, to initialize 
  668.                                the scrolling sequence.  This entry expects an 
  669.                                array of hexadecimal digits. 
  670.  
  671.  Scroll screen up each row     This parameter is sent one time for each row to 
  672.                                scroll.  This entry expects an array of 
  673.                                hexadecimal digits. 
  674.  
  675.  Clear screen                  This parameter is sent by Os2You to clear the 
  676.                                screen and position the cursor in home position. 
  677.                                This entry expects an array of hexadecimal 
  678.                                digits. 
  679.  
  680.  Clear line                    This parameter is sent by Os2You to clear the 
  681.                                remaining of the current row.  This entry 
  682.                                expects an array of hexadecimal digits. 
  683.  
  684.  TAB length                    This parameter specifies with what interval 
  685.                                tabulator stops are placed.  A tab character is 
  686.                                expanded to spaces by the terminal.  If you want 
  687.                                to disable the use of tab character to replace 
  688.                                multiple spaces you should set this value to 
  689.                                zero.  Often terminals does not advance to the 
  690.                                tab stop with spaces but instead only advances 
  691.                                the cursor.  In this case you must set this 
  692.                                parameter to zero.  This parameter expects a 
  693.                                decimal constant. 
  694.  
  695.  ANSI Colors                   This parameter specifies if ANSI color sequences 
  696.                                should be used.  This should only be set to YES, 
  697.                                if the terminal is compatible with ANSI/BBS 
  698.                                colors.  If this parameter is not set, colors 
  699.                                will be ignored. 
  700.  
  701.  Strip control chars           This parameter specifies that Os2You should 
  702.                                ignore any control characters visible on the 
  703.                                screen and send spaces instead. 
  704.  
  705.  Strip high chars              This parameter specifies that Os2You should 
  706.                                ignore any characters with a higher ASCII value 
  707.                                than 126 (decimal), except for some characters 
  708.                                (like box-drawing) which are translated to look 
  709.                                alike characters. 
  710.  
  711.  
  712. ΓòÉΓòÉΓòÉ 6.6. Exit setup ΓòÉΓòÉΓòÉ
  713.  
  714. Exit setup 
  715.  
  716.  This choice gives you a sub-menu that lets you choice between: 
  717.  
  718.  Save and exit       The configuration is saved in the file OS2YOU.CFG, and 
  719.                      Os2You is started (if the setup program was invoked by 
  720.                      Os2You). 
  721.  
  722.  Discard and exit    Any changes in the configuration will be discarded, and 
  723.                      Os2You is started (if the setup program was invoked by 
  724.                      Os2You).  Note, that changes in the modem or terminal 
  725.                      definitions have been saved anyhow. 
  726.  
  727.  Resume              The program will continue with the setup. 
  728.  
  729.  
  730. ΓòÉΓòÉΓòÉ 7. Terminal emulation ΓòÉΓòÉΓòÉ
  731.  
  732. Terminal emulation 
  733.  
  734.  To access the remote Os2You machine over an asynchronous line (cable or 
  735. modem), you will need a terminal emulation program (or a terminal), with one of 
  736. the terminal emulation modes supported by Os2You.  It doesn't matter which 
  737. operating system your terminal emulator is running.
  738.  
  739.  If you use OS/2 or DOS you may use the LanTerm2 (for OS/2) or LanTerm (for 
  740. DOS) programs for both terminal emulation over a network using named pipes, or 
  741. as an asynchronous terminal program. It will remap the keys to their 
  742. corresponding Esc-sequences, and is also compatible with the Os2You binary mode 
  743. (when running over a Pipe), which sometimes are faster than the terminal 
  744. emulation mode, when used on fast connections.
  745.  
  746.  If you don't want to use LanTerm(2), you may use any other terminal program 
  747. supporting one of the terminal emulation modes supported by Os2You.  Currently 
  748. the following terminals are supported by Os2You (ANSI is default if none 
  749. selected). 
  750.  
  751.  Terminal                                          Description file 
  752.  
  753.  ANSI/VT100/VT102                                  ANSI.PRM (not same as 
  754.                                                    default) 
  755.  
  756.  Hazeltine 1500                                    HAZEL.PRM (not tested) 
  757.  
  758.  IBM 3101                                          IBM3101.PRM 
  759.  
  760.  Tandberg TDV 2116                                 TANDBERG.PRM 
  761.  
  762.  Televideo 910-955/ADM 5/Wyse 50                   TELEVID.PRM 
  763.  
  764.  VT52/Heath/Zenith/ADDS VP                         VT52.PRM 
  765.  
  766.  Note that the description files only alter the screen output, and does not 
  767.  care about different keystroke combinations used by different terminals, 
  768.  except the ANSI escape keysequences. Also note that some terminals will work 
  769.  better if you run Os2You in a screen with only 24 lines (MODE CO80,24) instead 
  770.  of the more common 25 lines.  The following terminal programs are tested and 
  771.  seems to work with Os2You (except when otherwise indicated): 
  772.  
  773.  OS/Program                    Os2You terminal definition to use / comments 
  774.  
  775.  DOS LanTerm                   Use built in ANSI (ANSI.SYS should be loaded) 
  776.  
  777.  DOS Telix 3.15                Use built in ANSI (disable status line in Telix) 
  778.  
  779.  DOS Procomm+ 1.0              Use external ANSI, use only 24 lines in Os2You, 
  780.                                screen color backgrounds won't be correct 
  781.  
  782.  DOS Procomm+ 2.0              Use external ANSI, use only 24 lines in Os2You 
  783.                                (if you use the standard 25 line mode in 
  784.                                Procomm+) 
  785.  
  786.  OS2 LanTerm2                  Use built in ANSI 
  787.  
  788.  OS2 LogiComm 2.20S            Use built in ANSI 
  789.  
  790.  OS2 M2Zmodem 2.11             Use built in ANSI 
  791.  
  792.  OS2 HyperAccess 5/2           Use external ANSI, use only 24 lines in Os2You 
  793.  
  794.  OS2 TE/2 1.10A                Use built in ANSI 
  795.  
  796.  OS2 CKOKER 4E(070)            Use external ANSI, use only 24 lines in Os2You 
  797.  
  798.  PM  PMTerm                    Use built in ANSI 
  799.  
  800.  PM  Term2                     Use built in ANSI 
  801.  
  802.  PM  PMComm 1.07               Won't work with Os2You. Very strange scrolling 
  803.                                handling. 
  804.  
  805.  PM  XKOKER 5A(119)            Use external ANSI, use only 24 lines in Os2You 
  806.  
  807.  If your terminal is not supported with a terminal description file, you may 
  808.  define your own terminal, by starting the setup utility and select Terminal in 
  809.  the configuration menu. The program automatically detects how many columns and 
  810.  lines the OS/2 session contains, but you have to configure your terminal 
  811.  program for a screen size with at least the same amount of columns/lines (it 
  812.  doesn't matter if the terminal program uses more columns/lines than the OS/2 
  813.  session). It is possible to alter the screen size with the MODE-command, while 
  814.  connected to Os2You, as long as the screen will fit on the remote screen.
  815.  
  816.   To "emulate" different keystrokes, Esc sequences are used. The following Esc 
  817.  sequences are valid (note that upper/lower case letters are significant):
  818.  
  819.   Ch. Result Ch. Result Ch. Result    Ch. Res Ch. Result (?????)
  820.   === ====== === ====== === ======    === === === =====================
  821.    A  Alt-A   N  Alt-N  Esc Escape     1  F1   !  Shift/Ctrl/Alt-F1
  822.    B  Alt-B   O  Alt-O   t  BackTab    2  F2   @  Shift/Ctrl/Alt-F2
  823.    C  Alt-C   P  Alt-P                 3  F3   #  Shift/Ctrl/Alt-F3
  824.    D  Alt-D   Q  Alt-Q   w  Arr up     4  F4   $  Shift/Ctrl/Alt-F4
  825.    E  Alt-E   R  Alt-R   <  Arr left   5  F5   %  Shift/Ctrl/Alt-F5
  826.    F  Alt-F   S  Alt-S   >  Arr right  6  F6   ^  Shift/Ctrl/Alt-F6
  827.    G  Alt-G   T  Alt-T   z  Arr down   7  F7   &  Shift/Ctrl/Alt-F7
  828.    H  Alt-H   U  Alt-U                 8  F8   *  Shift/Ctrl/Alt-F8
  829.    I  Alt-I   V  Alt-V   c  Ctrl-Break 9  F9   (  Shift/Ctrl/Alt-F9
  830.    J  Alt-J   W  Alt-W                 0  F10  )  Shift/Ctrl/Alt-F10
  831.    K  Alt-K   X  Alt-X                 -  F11  _  Shift/Ctrl/Alt-F11
  832.    L  Alt-L   Y  Alt-Y                 =  F12  +  Shift/Ctrl/Alt-F12
  833.    M  Alt-M   Z  Alt-Z
  834.                                                s  Set F-key to Shift
  835.    i  Insert  h  Home    u  PageUp             l  Set F-key to Ctrl
  836.    d  Delete  e  End     n  PageDown           a  Set F-key to Alt
  837.   =====================================================================
  838.   Tab    Task list                     b  Toggle binary mode
  839.   Break  Force Os2You to exit          p  Toggle physical screen
  840.   Space  Force Os2You to update screen ?  Status information
  841.                                        y  Service functions
  842.  
  843.  The above screen is showed if you press Esc without any character following 
  844.  within approx. one second.  You may select any keystroke from the menu, and 
  845.  the menu exits, and Os2You sends the selected keystroke to your application. 
  846.  If Esc is pressed and directly followed by another character, the selected 
  847.  keystroke is sent directly to your application, without showing the help screen.
  848.  
  849.   ANSI escape sequences for cursor movements are mapped to their corresponding 
  850.  arrow key.
  851.  
  852.   All characters, except Esc, are translated directly to the corresponding 
  853.  keystroke.  ASCII 01H is translated to Ctrl-A, ASCII 02H to Ctrl-B and so on.
  854.  
  855.   To emulate Shift, Ctrl and Alt function keys, you have to first select which 
  856.  mode you want by pressing Esc-s, Esc-l resp. Esc-a first followed by the 
  857.  appropriate function key Esc-code. In the upper right corner of the help menu 
  858.  the current state of the function keys is written.
  859.  
  860.   The above table means that you should press Esc first and then a character. 
  861.  Esc-i means that you should press Esc first and then followed by i.  Note that 
  862.  you have to press Esc twice, if you want to emulate a Esc keystroke.
  863.  
  864.  
  865. ΓòÉΓòÉΓòÉ 8. LanTerm(2) terminal emulators ΓòÉΓòÉΓòÉ
  866.  
  867. LanTerm(2) terminal emulators 
  868.  
  869.  If you use OS/2 or DOS you may use the LanTerm2 (for OS/2) or LanTerm (for 
  870. DOS) programs for both terminal emulation over a network using named pipes, or 
  871. as an asynchronous terminal program. It will remap the keys to their 
  872. corresponding Esc-sequences, and is also compatible with the Os2You binary mode 
  873. (when running over a Pipe), which sometimes are faster than the terminal 
  874. emulation mode, when used on fast connections.
  875.  
  876.  If you want to run LanTerm2 or LanTerm on a asynchronous connection, you 
  877. should start LanTerm2 with the following syntax:
  878.  
  879.  LanTerm2 <COM-device> <baudrate> <PRN-device> <Script-file>
  880.  
  881.  LanTerm  <COM-device> <baudrate> <PRN-device> <Script-file> <TSR>
  882.  
  883.  Example:
  884.  
  885.  LanTerm COM1 19200 LPT1 MY_SCRIPT.TXT TSR 
  886.  
  887.  The device name must begin with COM (like COM1).  All other parameters are 
  888. optional, but must be specified in the above order if specified at all.  If no 
  889. baudrate is specified the program uses the default baudrate. The PRN-device 
  890. parameter specifies which device redirected printer output should be sent to 
  891. (see Printer redirection). When used for asynchronous communication, the 
  892. programs always sets the COM-device to 8 databits, 1 stopbits and no parity. 
  893. The LanTerm program for DOS, requires that ANSI.SYS is loaded in your 
  894. CONFIG.SYS file.  The DOS-mode program will only work with COM1 and COM2 serial 
  895. ports.  The programs are terminated by pressing Ctrl-Break.  LanTerm (for DOS), 
  896. may be installed as a Terminate and Stay Resident (TSR) program, allowing you 
  897. to switch between the remote OS/2 machine and the local DOS machine.
  898.  
  899.  If you use LanTerm(2), you don't have to use the Esc sequences, as LanTerm(2) 
  900. will map the keystrokes to the correct Esc sequences directly.  If you 
  901. specially want to use any of the Esc sequences above, you will have to press 
  902. RightShift-Esc followed by the keycode.
  903.  
  904.  Scripting:
  905.  
  906.  LanTerm, LanTerm2 and Terminal/2 are capable of simple scripting (type of 
  907. batch file processing for communications).  Script files are simple text files 
  908. you create with a text editor.  The following commands are available:
  909.  
  910.  RESPOND "xxxxx" "yyyyy"
  911.  
  912.  DELAYED RESPOND "xxxxx" "yyyyy" "zzz"
  913.  
  914.  QUIT "xxxxx"
  915.  
  916.  INITIAL "xxxxx"
  917.  
  918.  EXIT
  919.  
  920.  RESPOND                  Each time the string "xxxxx" is received "yyyyy" is 
  921.                           sent as response 
  922.  
  923.  DELAYED RESPOND          Each time the string "xxxxx" is received "yyyyy" is 
  924.                           sent after "zzz" seconds delay (zzz is a decimal 
  925.                           value) 
  926.  
  927.  QUIT                     When "xxxxx" is received the script file is 
  928.                           terminated. 
  929.  
  930.  INITIAL                  When scripting begins the "xxxxx" string is sent. 
  931.  
  932.  The ^ character is treated as an <Enter>.  Following is an example script file:
  933.  
  934.   INITIAL "ATDT 123456^"
  935.  
  936.   RESPOND "Press Enter to continue" "^"
  937.  
  938.   RESPOND "User name" "Mikael Wahlgren^"
  939.  
  940.   RESPOND "Password" "secret^"
  941.  
  942.   QUIT "Loading"
  943.  
  944.    EXIT
  945.  
  946.  
  947. ΓòÉΓòÉΓòÉ 9. Printer redirection ΓòÉΓòÉΓòÉ
  948.  
  949. Printer redirection 
  950.  
  951.  Printer output may be redirected from one device to a remote printer.  Note 
  952. that all output to the selected device is redirected, even output from other 
  953. sessions to this device.  You can select to direct printer output either to the 
  954. local printer, remote printer or both.  To redirect the printer output from one 
  955. device to a remote printer, you should install a printer driver for the remote 
  956. printer on the selected device.
  957.  
  958.  Example: 
  959.  
  960.  o You have a IBM Proprinter 4201 connected to LPT1 on the remote computer 
  961.    running LanTerm, LanTerm2 or Terminal/2. 
  962.  
  963.  o Install the IBM Proprinter 4201 printer driver for LPT2 on the host 
  964.    computer. 
  965.  
  966.  o Install Os2You to redirect LPT2 to remote computer. 
  967.  
  968.  o All output to LPT2 on the host will now be redirected to the remote printer. 
  969.    Other printer devices, like LPT1, will be unaffected. 
  970.  
  971.  Printer redirection requires that the terminal program on the remote computer 
  972.  is capable of handling this feature.  To use this feature, you will have to 
  973.  use LanTerm, LanTerm2 or Terminal/2.
  974.  
  975.   If you use a terminal program that can't handle this feature, and have 
  976.  installed Os2You to redirect printer output to remote printer, all printing 
  977.  will be put on hold.
  978.  
  979.  
  980. ΓòÉΓòÉΓòÉ 10. File transfer ΓòÉΓòÉΓòÉ
  981.  
  982. File transfer 
  983.  
  984.  By entering the Os2You Service Functions menu by pressing Esc-y, you can send 
  985. and receive files to/from the Os2You host.  Os2You will ask you for filenames 
  986. to send or directory to place received files in.  You may select multiple files 
  987. by using standard wild cards.  Os2You will use standard Ymodem-Batch protocol 
  988. for these types of file transfers.
  989.  
  990.  If you have Terminal/2, LanTerm2 or WinTerm, the file transfer protocol will 
  991. automaticly be invoked.  If you use any other terminal program, you will be 
  992. requested to start the file transfer procedure.
  993.  
  994.  If you have M2Zmodem version 2.09 or later (another program from the same 
  995. source), you may use it to up/download between the host and remote.  File 
  996. transfers using M2Zmodem is faster, by using standard Zmodem protocol, and is 
  997. invoked from the command line. This solution also allows auto Zmodem uploads. 
  998. I suggest that you copy the M2Zmodem.EXE and M2Zmodem.MSG files into the same 
  999. directory you used for Os2You. Then you should include this directory in your 
  1000. PATH and DPATH.
  1001.  
  1002.  It is now possible to receive files from host to remote (download) by just 
  1003. typing Sz <files> at the command prompt (any wildcards allowed).  If you run 
  1004. LanTerm2 or LanTerm as terminal program at the remote (or any other terminal 
  1005. program with Zmodem autodownload), the file transfer will be automatically 
  1006. started at the terminal side too, if not, you have to request download in your 
  1007. terminal program.
  1008.  
  1009.  If you use LanTerm (for DOS), you should get DSZ file transfer program 
  1010. (shareware from Omen Technology).  If you use LanTerm2 (for OS/2), you should 
  1011. get M2Zmodem file transfer program (shareware from the same place you got 
  1012. Os2You).  Both programs should be installed in the same directory as 
  1013. LanTerm(2), or in a directory specified in your path.
  1014.  
  1015.  To send files from remote to host (upload) just type Rz at the command prompt. 
  1016. When you request upload in your terminal program, you should enter which files 
  1017. to send.  If you have called your receive batch file Rz.Cmd you don't even have 
  1018. to start the batch file before starting your send procedure, because the Rz 
  1019. command is executed automatically by the Zmodem initializing procedure, if you 
  1020. are at the command line when you start the send procedure (auto Zmodem download).
  1021.  
  1022.  If you don't know how to get M2Zmodem, you could send a formatted diskette and 
  1023. four International Post reply coupons (Coupon-R╨Æponse International, Union 
  1024. Postale Universelle) to my address mentioned last in this documentation. 
  1025.  
  1026.  
  1027. ΓòÉΓòÉΓòÉ 11. Task list ΓòÉΓòÉΓòÉ
  1028.  
  1029. Task list 
  1030.  
  1031.  By pressing Esc-tab (first <Esc> and then <Tab> 1bH, 09H) you will get a list 
  1032. of programs currently running.  It might look like this: 
  1033.  
  1034.     ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù
  1035.     Γòæ -> 1  Return to original session Γòæ
  1036.     Γòæ    2  Switch to                  Γòæ
  1037.     Γòæ    3  OS/2 window                Γòæ
  1038.     Γòæ    4  Group - Communication      Γòæ
  1039.     Γòæ    5  M2ZMODEM.EXE               Γòæ
  1040.     Γòæ    6  Os2You.EXE                 Γòæ
  1041.     Γòæ    7  TS.EXE                     Γòæ
  1042.     Γòæ    8  Group - Main               Γòæ
  1043.     Γòæ    9  PM Diary                   Γòæ
  1044.     ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥
  1045.  
  1046. The task list displays all running programs.  If the list is too long for the 
  1047. screen, you may scroll up and down with the PgUp and PgDn keys.  You enter the 
  1048. digit displayed before the program you want to switch to, or move the arrow 
  1049. with the cursor keys.  If you want to return to the original session (the one 
  1050. you started from) you should select 1.
  1051.  
  1052.  You can only switch to programs running in an OS/2 Full Screen text session or 
  1053. DOS Full Screen text session (if you run Os2You with OS/2 2.0 or later).  If 
  1054. you try to switch to another session, you will get an error message.  Note that 
  1055. the session you select is switched to the foreground at the host machine, and 
  1056. will interrupt any user running another session at the machine from the 
  1057. keyboard.  It will also interrupt any other user running the same host through 
  1058. Os2You running other session than their original session.  The session you 
  1059. selected should not be switched to the background, while you are connected to 
  1060. it, as the user will be returned to the task-list if the task is switched to background.
  1061.  
  1062.  
  1063. ΓòÉΓòÉΓòÉ 12. DOS-compatibility box ΓòÉΓòÉΓòÉ
  1064.  
  1065. DOS-compatibility box 
  1066.  
  1067.  If you run OS/2 2.0 (or compatible) It is possible to switch to a Full Screen 
  1068. DOS compatibility box in OS/2 2.0.  Note that any user running at the physical 
  1069. screen will be interrupted when the DOS-box is entered. Otherwise you can 
  1070. access the DOS-box just like you access the other OS/2 sessions.
  1071.  
  1072.  For the DOS-box access to work, you must take some extra care to configure 
  1073. your system.  First, the DOS_SRV.EXE program must be located in the directory 
  1074. you installed Os2You in (or in a pathed directory).  If this is not the case 
  1075. you will get a message like "DOS Keyboard emulation not available!".
  1076.  
  1077.  Then you must load the resident program KBFILTER.COM in the DOS-box you want 
  1078. to access remotely, in order to get the function keys to work (other characters 
  1079. will work without this program).  You can either load the program from the 
  1080. remote, when you have switched to the DOS-session, or you can load the program 
  1081. KBFILTER.COM in your AUTOEXEC.BAT file.  The program will require very little 
  1082. memory (less than 1 Kb) and interfere very little with your usual work (the 
  1083. Esc-key can seem a little slow).
  1084.  
  1085.  If you can see the DOS-box screen output, but not send any keystrokes at all, 
  1086. this probably means that DOS_SRV.EXE isn't loaded properly.  If you can send 
  1087. alphanumerical characters, but no function keys, that probably means that 
  1088. KBFILTER.COM isn't loaded properly.
  1089.  
  1090.  Note that KBFILTER.COM could be loaded several times.  This is not recommended.
  1091.  
  1092.  
  1093. ΓòÉΓòÉΓòÉ 13. Sharing ports with other communication programs ΓòÉΓòÉΓòÉ
  1094.  
  1095. Sharing ports with other communication programs 
  1096.  
  1097.  If you have set up Os2You in HOST mode to answer incoming calls, it is 
  1098. possible to temporarily suspend Os2You, to let other communication programs 
  1099. access the port.  To do this you have to enter a pipe name in the configuration 
  1100. parameter Port request pipe (like "\PIPE\RELEASE").  To do this you run the 
  1101. program LanRel with one of the following syntaxes:
  1102.  
  1103.  LanRel \Pipe\Release
  1104.  
  1105.  LanRel \\Srvname\Pipe\Release
  1106.  
  1107.  if the port request pipe was called \Pipe\Release.  It is possible to use both 
  1108. local and remote pipes, so you can suspend Os2You on your local or LAN Os2You 
  1109. Host.  The pipe name may also be a pipe bridged by the LanBridg software.
  1110.  
  1111.  When Os2You gets a port request, it releases the communication port and halts 
  1112. for one (1) minute, leaving the port available.  By using LanRel you will have 
  1113. 1 minute to start any other communication program accessing the port, and 
  1114. Os2You will remain suspended until the port is available again.  Os2You 
  1115. automatically detects when the port is available again, and will resume its 
  1116. operation again.  The port is re-initialized when operation is resumed.
  1117.  
  1118.  It is also possible to access the port directly with LanTerm or LanTerm2 by 
  1119. starting these programs with the Port request pipe name as a parameter to the 
  1120. LanTerm(2) program, instead of the communication device name 
  1121.  
  1122.  
  1123. ΓòÉΓòÉΓòÉ 14. Multi user configuration ΓòÉΓòÉΓòÉ
  1124.  
  1125. Multi user configuration 
  1126.  
  1127.  By using Os2You you may actually use OS/2 in a multi user like manner.  Note 
  1128. that Os2You lacks any sort of security control for file managing, which a 
  1129. "normal" multi user operating system includes.
  1130.  
  1131.  
  1132. ΓòÉΓòÉΓòÉ 15. Compatibility with other programs ΓòÉΓòÉΓòÉ
  1133.  
  1134. Compatibility with other programs 
  1135.  
  1136.  The following programs are tested and seems to work with Os2You (to be run via 
  1137. Os2You remote).  Note that some tests were rather brief and compatibility is 
  1138. not guaranteed (if not otherwise noted, programs are OS/2 versions):
  1139.  
  1140.  CMD.EXE 1.30 (IBM OS/2 1.30) and all full screen programs included with OS/2
  1141.  
  1142.  4OS2.EXE 0.95 (problems with forced termination)
  1143.  
  1144.  Brief 3.0 (some ALT-key combinations will react very slowly)
  1145.  
  1146.  JPI TopSpeed environment and VID 
  1147.  
  1148.  MS C 6.00, PWB and other compiler components (CVP program output fails)
  1149.  
  1150.  IBM Lan Server 1.3 (NET-program)
  1151.  
  1152.  M2Zmodem
  1153.  
  1154.  TE/2
  1155.  
  1156.  Logicomm
  1157.  
  1158.  Ckoker (Kermit)
  1159.  
  1160.  Os2You (and included programs like LanTerm and LanTerm2)
  1161.  
  1162.  MsgEd 2.06
  1163.  
  1164.  Binkley term 2.30
  1165.  
  1166.  Maximus 2.00
  1167.  
  1168.  Ommm 1.40
  1169.  
  1170.  ConfMail 2.0/3.31
  1171.  
  1172.  Mountain FileSafe streamer software 
  1173.  
  1174.  PKZip 1.02 (and included programs)
  1175.  
  1176.  Zoo 1.51
  1177.  
  1178.  LHarc 1.13
  1179.  
  1180.  DDump 0.01 hex editor 
  1181.  
  1182.  Hack 1.03
  1183.  
  1184.  NetHack 3.0
  1185.  
  1186.  Column (tetris like game)
  1187.  
  1188.  Tetris2
  1189.  
  1190.  Cave (adventure game)
  1191.  
  1192.  COMMAND.COM (DOS)
  1193.  
  1194.  WordPerfect 5.0 (DOS)
  1195.  
  1196.  Turbo Pascal 5.0
  1197.  
  1198.  The following programs are tested and do not work with Os2You:
  1199.  
  1200.  Lotus 1-2-3 3.0 (keyboard input works but no screen output)
  1201.  
  1202.  Note:  The above programs are trademarks of their respective company.
  1203.  
  1204.  
  1205. ΓòÉΓòÉΓòÉ 16. Command line options ΓòÉΓòÉΓòÉ
  1206.  
  1207. Command line options 
  1208.  
  1209.  If you want to start the program from the OS/2 Command prompt without the 
  1210. phone answering capabilities, or want to call the program from your own 
  1211. application, the program is started with some parameters.  The program may use 
  1212. a hot file handle (already opened).
  1213.  
  1214.  It is the callers responsibility to set the communication port as wanted, and 
  1215. Os2You will use the current settings when called.
  1216.  
  1217.  When the program exits, it restores the communication port to its previous 
  1218. state.  If a program was successfully spawned the program will exit with 
  1219. Exit-code set to zero.  If the program failed by any reason, the Exit-code will 
  1220. be set to a non zero value.
  1221.  
  1222.  The parameters may be entered at the command line or/and set in the 
  1223. environment variable OS2YOU.  If both the environment variable and a command 
  1224. line is entered, the environment variable will be parsed first and the command 
  1225. line after that, making command line parameters override any settings in the 
  1226. environment variable.  The environment variable is set by the SET OS2YOU=xxx 
  1227. xxxx xxxx xxx command.  The following parameters are available (note that they 
  1228. should be lower case).
  1229.  
  1230.  Switch                   Description 
  1231.  
  1232.  -c <fname>               Use the configuration file <fname>. This option is 
  1233.                           only valid if you use HOST mode or callback 
  1234.                           processing. 
  1235.  
  1236.  -d                       Do not detect carrier loss.  Normally the program 
  1237.                           monitors the carrier and close the remote session if 
  1238.                           carrier is lost.  By adding this parameter you 
  1239.                           override this behavior. 
  1240.  
  1241.  -e <fname>               Execute program <fname> for the remote session 
  1242.                           (typically CMD.EXE).  This parameter is the last one 
  1243.                           read by Os2You.  All following parameters are sent to 
  1244.                           the called program. Default is CMD.EXE. 
  1245.  
  1246.  -f <decint>              Delay between screen updates with <decint> 
  1247.                           milliseconds.  Default is 100 mSecs (0.1 seconds). 
  1248.  
  1249.  -g <session-name>        Go to session <session-name> directly. 
  1250.  
  1251.  -i <decint>              Exit if keyboard inactive in <decint> seconds.  If 
  1252.                           set to zero no inactivity time-out is used.  Note 
  1253.                           that only the keyboard activity is monitored, and 
  1254.                           that the inactivity counter is active even if the 
  1255.                           screen alters. Default is zero (no inactivity 
  1256.                           counter). 
  1257.  
  1258.  -l <dname>               Use device <dname> for communication. If <dname> is 
  1259.                           replaced by a percent sign and a decimal value (for 
  1260.                           example %5), the program will use the device handle 
  1261.                           (5 in the example) for communication.  The program 
  1262.                           may also use pipes handles for communication. This 
  1263.                           parameter has no default value, and if the parameter 
  1264.                           is omitted, the program will start up in HOST mode. 
  1265.  
  1266.  -n <uname>               Use parameters for user <uname> in the configuration 
  1267.                           file, including callback processing to <uname>.  This 
  1268.                           parameter is only valid if you do not start the 
  1269.                           program in HOST mode.  If you want to include spaces 
  1270.                           in the <uname> you should replace the space by an 
  1271.                           underscore "_", or surround the parameter with double 
  1272.                           quotes. Default is to not use any entries in the 
  1273.                           configuration file. 
  1274.  
  1275.  -p                       Use physical screen area for remote.  If this 
  1276.                           parameter is specified the program will use the 
  1277.                           physical screen area for remote, and not the screen 
  1278.                           area owned by the session.  If this parameter is 
  1279.                           specified you can't use the -s parameter. Default is 
  1280.                           to use the session screen area. 
  1281.  
  1282.  -prn <dname>             Redirect printer output for <dname> to the remote 
  1283.                           printer.  This parameter works in combination with 
  1284.                           the -redir option. 
  1285.  
  1286.  -prty <decint>           Screen update priority <decint> 0-39. This parameter 
  1287.                           sets the priority for the remote screen update 
  1288.                           thread.  Zero is the lowest priority and 39 the 
  1289.                           highest.  Priority 0-9 executes with IDLE priority, 
  1290.                           10-19 has REGULAR priority, 20-29 HIGH priority and 
  1291.                           30-39 TIME CRITICAL priority.  If priority is set to 
  1292.                           14 the screen update thread has the exact same 
  1293.                           priority as the executed program. Default is 14 
  1294.                           giving the update thread exactly the same priority as 
  1295.                           the executing program.  Setting the priority to a 
  1296.                           higher value (15) may result in smother operation. 
  1297.  
  1298.  -redir <decint>          Specifies how printer redirection should work.  If 
  1299.                           <decint> is 1, printer output will go to local (host) 
  1300.                           printer.  If <decint> is 2 printer output will be 
  1301.                           redirected to the remote printer.  If <decint> is 3 
  1302.                           printer output will be redirected to the remote 
  1303.                           printer, but also sent to the local (host) printer. 
  1304.  
  1305.  -s                       Disable the built in task switcher and physical 
  1306.                           screen. If you don't want the remote user to be able 
  1307.                           to switch between running tasks, you should disable 
  1308.                           this feature.  If this parameter is specified you 
  1309.                           can't use the -p parameter.  Default is to enable the 
  1310.                           task switcher. 
  1311.  
  1312.  -t <fname>               Use terminal definition file <fname>. The file 
  1313.                           extension .PRM is added if no extension is included. 
  1314.                           This parameter has no default value, instead the 
  1315.                           program has a built in table for ANSI terminal 
  1316.                           emulation. 
  1317.  
  1318.   Examples:
  1319.  
  1320.   Os2You -l COM1 -f 1000 -i 300 -e CMD.EXE /K DIR 
  1321.  
  1322.   This command will tell Os2You to use COM1 and update the screen each 1000 
  1323.  millisecond.  If no remote keystroke is received within 300 seconds the 
  1324.  program will be forced to exit. CMD.EXE is loaded for remote operation with 
  1325.  the parameters /K DIR (which will tell CMD.EXE to display a directory list).
  1326.  
  1327.   Os2You -l %4 -f 100 -i 0 -d -e CMD.EXE
  1328.  
  1329.   This command will tell Os2You to use device handle 4 (decimal value) and 
  1330.  update the screen each 100 millisecond.  If carrier i lost the program will be 
  1331.  terminated. but no inactivity timer is set.
  1332.  
  1333.   Os2You -l %4 -f 100 -i 0 -d -n Mikael_Wahlgren
  1334.  
  1335.   This command is similar to the previous example, except that the program will 
  1336.  spawn the program and use the parameters indicated by the username Mikael 
  1337.  Wahlgren in the configuration file.  By using the -n option it is possible to 
  1338.  spawn different session depending on username.
  1339.  
  1340.   To be compatible with MaxPipe (TM of Peter Fitzsimmons) an alternate calling 
  1341.  syntax is automatically invoked, if the first parameter does not begin with a 
  1342.  minus sign "-".  In this case, the syntax will be like:
  1343.  
  1344.   Os2You <device> <prgname> <parm1> ... <parmN> 
  1345.  
  1346.  <device>       Tells which communication device to use.  It is possible to 
  1347.                 pass a hot device handle by replace the device name with a 
  1348.                 number corresponding to a the device handle decimal coded (like 
  1349.                 %4). The device name may be replaced by a pipe name, but 
  1350.                 special care should be taken, when using this possibility.  The 
  1351.                 best choice when using pipes is to use the stand alone 
  1352.                 interface. 
  1353.  
  1354.  <prgname>      Tells which program to load for remote operation. (Typically 
  1355.                 CMD.EXE). 
  1356.  
  1357.  <parm1> ...    The remaining parameters are optional and are passed as 
  1358.                 parameters to <parmN> ... <prgname>. 
  1359.  
  1360.  All other values are set to their default when using this syntax. To select 
  1361.  which communication parameters to use, you should use the MODE program, 
  1362.  included with the operating system.  See more in the documentation for the 
  1363.  operating system to see how to configure your communication line.  All 
  1364.  communication parameters set with MODE, will be used with Os2You.
  1365.  
  1366.    Example:
  1367.  
  1368.   MODE COM1:2400,N,8,1,OCTS=ON,DTR=ON,RTS=HS,BUFFER=ON
  1369.  
  1370.   This command will tell Os2You to use baud rate 2400, no parity, 8 data bits, 
  1371.  1 stop bit, hardware handshaking CTS/RTS and use the extended hardware 
  1372.  buffering capabilities.
  1373.  
  1374.   If you want to install Os2You with Maximus (TM) BBS, these lines may be of help:
  1375.  
  1376.   UsrRemote Xtern_Run OS2YOU.EXE_-l_%%%P_-f_1000_-i_300_-t_ANSI Sysop "/OS-2"
  1377.  
  1378.   Update delay 1 second, inactivity time-out 300 seconds, terminal ANSI, spawn 
  1379.  a CMD.EXE session.
  1380.  
  1381.   UsrRemote Xtern_Run OS2YOU.EXE_-l_%%%P_-e_MyProg.EXE Sysop "/OS-2"
  1382.  
  1383.   Use Os2You defaults, spawn program MyProg.EXE
  1384.  
  1385.  
  1386. ΓòÉΓòÉΓòÉ 17. Use within a BBS ΓòÉΓòÉΓòÉ
  1387.  
  1388. Use within a BBS 
  1389.  
  1390.  This program can be used to access the command prompt from your BBS, for 
  1391. maintenance, or to run programs as doors within the BBS.  The following is some 
  1392. examples of how to install Os2You in a BBS (Maximus 2.00)
  1393.  
  1394.  Start a command prompt from Maximus with the following syntax:
  1395.  
  1396.  UsrRemote Xtern_Run Os2You.EXE_-l_%%%P_-f_1000_-s_-t_ANSI_-e_CMD.EXE Normal "Shell"
  1397.  
  1398.  Start an OS/2-program called "MyProg" from Maximus with the following syntax:
  1399.  
  1400.  UsrRemote Xtern_Run Os2You.EXE_-l_%%%P_-f_1000_-s_-t_ANSI_-e_CMD.EXE_/C_MyProg 
  1401. Normal "MyProg"
  1402.  
  1403.  Start a DOS-program called "MyDOS" from Maximus with the following syntax:
  1404.  
  1405.  UsrRemote Xtern_Run 
  1406. Os2You.EXE_-l_%%%P_-f_1000_-s_-t_ANSI_-g_"DOS.BAT"_-e_CMD.EXE_/C_DOS Normal "MyDOS"
  1407.  
  1408.  You should have a batch file called DOS.BAT like this: 
  1409.  
  1410. @echo off
  1411. MYDOS
  1412.  
  1413.  
  1414. ΓòÉΓòÉΓòÉ 18. Commonly asked questions and problems ΓòÉΓòÉΓòÉ
  1415.  
  1416. Commonly asked questions and problems 
  1417.  
  1418.  What terminal program should I use to communicate with Os2You and which 
  1419. terminal emulation mode?
  1420.  
  1421.  For the best possible emulation, you should use the included LanTerm (for DOS) 
  1422. or LanTerm2 (for OS/2).  If you want to use your favorite terminal program you 
  1423. should select ANSI-BBS emulation if it is available and the built in or 
  1424. ANSI.PRM terminal mode in Os2You.
  1425.  
  1426.  When started in HOST-mode configured for a cable connection, Os2You loops 
  1427. around, asking for <Enter> and eventually logon parameters, even if no user are calling.
  1428.  
  1429.  If you have installed Os2You for cable, Os2You relies entirely on the DCD 
  1430. (Data Carrier Detect) signal on the RS232-interface to reflect the real carrier 
  1431. state.  DCD is a signal that tells the computer that the modem is connected to 
  1432. another modem.  You have to verify that the signal on the RS232 interface is 
  1433. connected to the signal at the modems interface, and that the modem is 
  1434. configured to reflect the real carrier state.
  1435.  
  1436.  When logging on to Os2You HOST mode, I first get a lot of garbage characters, 
  1437. before I get the Press Enter message.
  1438.  
  1439.  This is normal, if you use a cable connection and you have configured Os2You 
  1440. for multiple baud rates. Os2You tries to find the correct baud rate for you.
  1441.  
  1442.  The screen doesn't scroll correctly.
  1443.  
  1444.  Scrolling has proved to be the hardest part to implement. This has to do with 
  1445. the fact that the Os2You program has no way to find out how many lines your 
  1446. terminal program on the remote has.  The built in ANSI driver in Os2You sends a 
  1447. command to move the cursor down 999 lines and sends a LF.  If the built in ANSI 
  1448. terminal doesn't work, you should modify ANSI.PRM (or the terminal definition 
  1449. file that is appropriate for your terminal), and alter the scroll sequences.
  1450.  
  1451.  Background colors are not displayed correctly at the remote screen, using ANSI colors.
  1452.  
  1453.  When Os2You sends a ClrEol (Clear to end of line) sequence, it assumes that 
  1454. the line is cleared with the attribute currently in use.  This is how it works 
  1455. in the ANSI driver for OS/2.  Some terminal emulators though, fill the cleared 
  1456. line with the standard attribute in opposite to the currently used attribute.
  1457.  
  1458.  When running some programs, I don't get any output from it.
  1459.  
  1460.  Os2You is not compatible with programs running in Presentation Manager. Some 
  1461. programs running in OS/2 full screen text sessions require the physical screen 
  1462. buffer. Those programs won't be 100% compatible with Os2You, but you might be 
  1463. able to run the program if you use the task switcher and switch to the 
  1464. offending program, as programs selected by the task switcher will run in the 
  1465. foreground and have the physical screen adressable.
  1466.  
  1467.  When running some programs, I get output from the program, but the keyboard 
  1468. doesn't seem to work.
  1469.  
  1470.  The programs keyboard handling is not compatible with Os2You.  Please report 
  1471. the problem, and if possible, send a copy of the offending program.
  1472.  
  1473.  
  1474. ΓòÉΓòÉΓòÉ 19. Hardware information ΓòÉΓòÉΓòÉ
  1475.  
  1476. Hardware information 
  1477.  
  1478.  This section contains some useful technical hardware information, like modem 
  1479. cabling and hardware selection.  If you click at the plus sign on the left of 
  1480. this header in the main menu, you will get a list of available items. 
  1481.  
  1482.  
  1483. ΓòÉΓòÉΓòÉ 19.1. Hardware requirements ΓòÉΓòÉΓòÉ
  1484.  
  1485. Hardware requirements 
  1486.  
  1487.  Os2You should run on any system that can run OS/2 Presentation Manager and 
  1488. OS/2 Full Screen text applications. 
  1489.  
  1490.  o Os2You assumes that you use a display card with 2 bytes/character attribute 
  1491.    format, compatible with the CGA/EGA/VGA standards. 
  1492.  
  1493.  o Os2You have modest memory requirements, and should run fine with almost any 
  1494.    system that can run OS/2. 
  1495.  
  1496.  o Os2You is compatible with any asynchronous port, compatible with the OS/2 
  1497.    specification.  FIFO buffering can be used, and is recommended. 
  1498.  
  1499.  o Os2You can use any Hayes compatible modem, and it should be possible to 
  1500.    configure Os2You for almost any automatic modem.  MNP5 or V.42" data 
  1501.    compression is very valuable when using Os2You. 
  1502.  
  1503.  o Os2You emulates an enhanced keyboard. 
  1504.  
  1505.  
  1506. ΓòÉΓòÉΓòÉ 19.2. Creating a null-modem ΓòÉΓòÉΓòÉ
  1507.  
  1508. Creating a null-modem
  1509.  
  1510.  If you use Os2You to access an OS/2 session from a computer or terminal using 
  1511. a cable, this is how such a cable (null-modem) should be configured, to work 
  1512. with Os2You. 
  1513.  
  1514. 25 Dsub             25 Dsub
  1515. TxD  2 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 3  RxD
  1516. RxD  3 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 2  TxD
  1517. RTS  4 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 5  CTS
  1518. CTS  5 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 4  RTS
  1519. GND  7 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 7  GND
  1520. DTR 20 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇ 6  DSR
  1521.                 ΓööΓöÇΓöÇ 8  DCD
  1522. DSR 6  ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 20 DTR
  1523. DCD 8  ΓöÇΓöÇΓöÿ
  1524.  
  1525. 9 Dsub              9 Dsub
  1526. TxD  3 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 2  RxD
  1527. RxD  2 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 3  TxD
  1528. RTS  7 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 8  CTS
  1529. CTS  8 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 7  RTS
  1530. GND  5 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 5  GND
  1531. DTR  4 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇ 6  DSR
  1532.                 ΓööΓöÇΓöÇ 1  DCD
  1533. DSR  6 ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 4  DTR
  1534. DCD  1 ΓöÇΓöÇΓöÿ
  1535.  
  1536. 9 Dsub              25 Dsub
  1537. TxD  3 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 3  RxD
  1538. RxD  2 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 2  TxD
  1539. RTS  7 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 5  CTS
  1540. CTS  8 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 4  RTS
  1541. GND  5 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 7  GND
  1542. DTR  4 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇ 6  DSR
  1543.                 ΓööΓöÇΓöÇ 8  DCD
  1544. DSR  6 ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 20 DTR
  1545. DCD  1 ΓöÇΓöÇΓöÿ
  1546.  
  1547.  
  1548. ΓòÉΓòÉΓòÉ 19.3. Creating a modem cable ΓòÉΓòÉΓòÉ
  1549.  
  1550. Creating a modem cable 
  1551.  
  1552.  If you use Os2You with an asynchronous modem, this is how the cable between 
  1553. your computer and modem should look like to work with Os2You. 
  1554.  
  1555. 25 Dsub             Modem
  1556. TxD  2 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 2
  1557. RxD  3 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 3
  1558. RTS  4 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 4
  1559. CTS  5 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 5
  1560. DSR  6 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 6
  1561. GND  7 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 7
  1562. DCD  8 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 8
  1563. DTR 20 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 20
  1564.  
  1565. 9 Dsub              Modem
  1566. TxD  3 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 2
  1567. RxD  2 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 3
  1568. RTS  7 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 4
  1569. CTS  8 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 5
  1570. DSR  5 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 6
  1571. GND  5 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 7
  1572. DCD  1 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 8
  1573. DTR  4 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 20
  1574.  
  1575.  
  1576. ΓòÉΓòÉΓòÉ 20. Programming information ΓòÉΓòÉΓòÉ
  1577.  
  1578. Programming information 
  1579.  
  1580.  This section contains some useful technical programming information. If you 
  1581. click at the plus sign on the left of this header in the main menu, you will 
  1582. get a list of available items. 
  1583.  
  1584.  
  1585. ΓòÉΓòÉΓòÉ 20.1. Communication with pipes ΓòÉΓòÉΓòÉ
  1586.  
  1587. Communication with pipes 
  1588.  
  1589.  Os2You creates a named pipe with unlimited pipe instances possible. The pipe 
  1590. is a full duplex message pipe with no write behind allowed. Os2You tries to 
  1591. allocate a 16 Kbyte output buffer and 1 Kbyte input buffer, but will work with 
  1592. any buffer size actually supplied by the API.
  1593.  
  1594.  If the pipe is broken by Os2You, this will mean that Os2You has ended the 
  1595. conversation with the terminal program.
  1596.  
  1597.  If the pipe is broken by the terminal program during a conversation, Os2You 
  1598. will treat this as a carrier loss, and try to end the running program, and the 
  1599. current remote session.
  1600.  
  1601.  Reading the pipe 
  1602.  
  1603.  A terminal program wishing to communicate with Os2You via pipes should 
  1604. preferable open the pipe in blocking mode and in message read mode.  Note that 
  1605. when coding for a single tasking environment (like DOS), it might be necessary 
  1606. to use non blocking mode, as you have to serve writing, even if you don't get 
  1607. anything reading the pipe.  It is possible to put the Os2You program in "Anti 
  1608. blocking mode", which means that Os2You will send "empty" messages (=Flag set 
  1609. to 0) to prevent blocking when reading the pipe.  This is done by sending first 
  1610. Esc and then zero (1Bh, 00h).  A message will have the following structure: 
  1611.  
  1612.   RECORD
  1613.     Flag     : CHAR;                     (* One byte character *)
  1614.     CurRow   : CARDINAL;                 (* Two byte unsigned integer *)
  1615.     CurCol   : CARDINAL;                 (* Two byte unsigned integer *)
  1616.     Length   : CARDINAL;                 (* Two byte unsigned integer *)
  1617.     Reserved : ARRAY [1..30000] OF CHAR; (* 30000 byte character buffer *)
  1618.   END;
  1619.  
  1620. The message is of variable size.  When a message is received, the Flag 
  1621. character will reflect the type of message received.
  1622.  
  1623.  If Flag is set to 00H this indicates the session begins.  No special action is 
  1624. required of the terminal program, but it might send a Esc-b sequence to set 
  1625. Os2You to binary screen mode.
  1626.  
  1627.  If Flag is set to 01H this indicates a cursor position command.  The CurRow 
  1628. and CurCol parameters will contain the cursor positions the terminal program 
  1629. should set.  If the Length value is non-zero a new message will follow 
  1630. immidiatly, containing a direct image of the video buffer.  The whole message 
  1631. (or as much of it that is allowed by the terminal programs screen size), should 
  1632. be placed in the logical video buffer, and be displayed.  Note, that if CurRow 
  1633. and CurCol both are set to 65535 (all bits set), this means that the Os2You 
  1634. session is ending.
  1635.  
  1636.  If Flag is set to any other value than 00H or 01H, the whole message will 
  1637. contain text that should be displayed at the screen with a ordinary write 
  1638. command.  It might contain ANSI-sequences, so your terminal program should set 
  1639. the ANSI-mode on.
  1640.  
  1641.  If the terminal can't read the pipe in message mode, it is still possible to 
  1642. get all functionality using ordinary byte stream mode, although this will 
  1643. require more coding.  It is recommended to use non blocking mode when writing 
  1644. DOS-applications as DOS is not reentrant and you can't write to the pipe, while 
  1645. the program is blocked in a read operation.  The program should behave in the 
  1646. following manner:
  1647.  
  1648.  Read a block of any size from the pipe.  Scan and retain the position for the 
  1649. first occurance of a 00H byte in the block.  Scan and retain the position for 
  1650. the first occurance of a 01H byte in the block.
  1651.  
  1652.  Write the characters before the first occurance of 00H or 01H byte to screen, 
  1653. using ordinary write-commands.
  1654.  
  1655.  If the position for the 00H byte is less than the position for 01H byte, a 
  1656. Flag of 00H is assumed, and proper action is taken.
  1657.  
  1658.  If the position for the 01H byte is less than 00H byte a Flag of 01H is 
  1659. assumed.  Assure that you have at least six characters following the Flag byte, 
  1660. and map them to the message block showed above.  Set the cursor position 
  1661. according to this.  If the Length value is set in this block, you should read 
  1662. Length bytes further (including any previous read bytes not used yet), and move 
  1663. these bytes directly to video memory.
  1664.  
  1665.  Any trailing characters not yet used by previous decoding, should be rescanned 
  1666. and decoded again, until there are no 00H or 01H bytes in the remaining block. 
  1667. This remaining block should then be displayed using ordinary write commands.
  1668.  
  1669.  Note, that OS/2 1.2 and Lan Server 1.2 didn't work correctly sometimes when 
  1670. reading large messages from a remote pipe.  Therefore you should limit your 
  1671. pipe reads to maximum 4 kByte reads, and merge the next read with the current 
  1672. if you get the ERRROR_MORE_DATA error.
  1673.  
  1674.  Writing to the pipe 
  1675.  
  1676.  To send characters to Os2You, the terminal program should send messages of the 
  1677. length one byte, containing the ASCII-code of the character sent to Os2You.  It 
  1678. is important that no messages longer than 1 byte are sent over the pipe, as 
  1679. Os2You will just ignore the remaining part of the message or treat it as an 
  1680. invalid client, and end the conversation.  The same Esc sequences as described 
  1681. in the documentations are used when using pipes.
  1682.  
  1683.  Examples
  1684.  
  1685.  Here is an example on how the read pipe (message mode) thread looks like in 
  1686. Lanterm2.Mod: 
  1687.  
  1688. LOOP
  1689.   BytesRead := PipeRead();         (* Read Pipe and place result in Buffer *)
  1690.   CASE Buffer.Flag OF
  1691.     | CHR(0) : TempCh := CHR(27);
  1692.                Dos.Write(Handle,ADR(TempCh),1,BytesWritten);
  1693.                TempCh := 'b';
  1694.                Dos.Write(Handle,ADR(TempCh),1,BytesWritten);
  1695.     | CHR(1) : Vio.SetCurPos(Buffer.CurRow,Buffer.CurCol,0);
  1696.                IF Buffer.Length <> 0 THEN
  1697.                  BytesRead := PipeRead();
  1698.                  IF BytesRead > ScrLen THEN
  1699.                    Lib.WordMove(ADR(Buffer),LVBPtr,ScrLen DIV 2);
  1700.                  ELSE
  1701.                    Lib.WordMove(ADR(Buffer),LVBPtr,BytesRead DIV 2);
  1702.                  END;
  1703.                  Vio.ShowBuf(0,ScrLen,0);
  1704.                END;
  1705.       ELSE     Vio.WrtTTY(ADR(Buffer),BytesRead,0);
  1706.   END;
  1707. END;
  1708.  
  1709.  
  1710. ΓòÉΓòÉΓòÉ 21. Important license information ΓòÉΓòÉΓòÉ
  1711.  
  1712. Important license information 
  1713.  
  1714.  It is illegal (or at least unethical) to patch the program in any way.  Any 
  1715. reverse engineering (disassembling or monitoring) is not an approved use of the application.
  1716.  
  1717.  If you register the software with at least 500 SEK (about $75), or 250 SEK for 
  1718. Sysop/BBS use only, you will get a license file and a copy of the most recent 
  1719. version of the program.  By registering you will get the following benefits: 
  1720.  
  1721.  o You will get a diskette with the most recent version of Os2You/M2Zmodem. 
  1722.  
  1723.  o You will get rid of the introduction/registration screen during logon. 
  1724.  
  1725.  o You will get a PM Terminal program for running Os2You via modem or Pipe. 
  1726.  
  1727.  o You will be able to run Os2You with 38400, 57600 and 115200 bauds. 
  1728.  
  1729.  o You will be treated as registered user for all future release. 
  1730.  
  1731.  o You can sleep at the night without having your conscience haunt you. 
  1732.  
  1733.  If you use the program on a regular basis, or in commercial use, you must 
  1734.  register with minimum the above mentioned sum for each machine running the 
  1735.  Os2You program.  The LanTerm, LanTerm2 and LanBridg programs don't need any 
  1736.  further registration, and may be used in unlimited instances, but an extra 
  1737.  registration per each 20th instance of LanTerm or LanTerm2 is appreciated.
  1738.  
  1739.   Note that the file transfer option requires registration.  Neither the built 
  1740.  in file transfer function or the Sz/Rz commands will work without this option.
  1741.  
  1742.   The sourcecode (in Modula-2) of the program is available, on special terms. 
  1743.  Please contact me if this is of interest.
  1744.  
  1745.   You are encouraged to spread this program (without registration file) to 
  1746.  anyone that might be interested.
  1747.  
  1748.   If you want to register, send Swedish banknotes, bank check (payable in 
  1749.  Swedish bank) or pay with VISA or MasterCard by completing the order form 
  1750.  printable from the file ORDER.DOC.
  1751.  
  1752.   My address is: 
  1753.  
  1754.   Mikael Wahlgren
  1755.   Kransen 4E
  1756.   S-416 72  GOTHENBURG
  1757.   Sweden
  1758.   Fax: +46 31 196417
  1759.   Phone: +46 31 196074
  1760.   Fidonet: Mikael Wahlgren 2:203/302.5
  1761.   Internet: d9mikael@dtek.chalmers.se
  1762.  
  1763.   Use the following form to register your copy of Os2You and M2Zmodem: 
  1764.  
  1765.                                        INVOICE
  1766.  
  1767.                                                        Date: ___________
  1768.  
  1769.          TO:                                           FROM:
  1770.  
  1771.          Name: ____________________________________    M Wahlgren Software Dev.
  1772.                                                        Kransen 4E
  1773.          Company: _________________________________    S-416 72  Gothenburg
  1774.                                                        Sweden
  1775.          Address: _________________________________
  1776.  
  1777.          City, State; _____________________________
  1778.  
  1779.  
  1780.  
  1781.          Diskette format                  5.25" disk ____    3.5" disk ____
  1782.  
  1783.  
  1784.          Specification                             Amount Price Sum
  1785.          ========================================= ====== ===== ===========
  1786.  
  1787.          Os2You remote software (first 1-9)        ______   500  __________
  1788.  
  1789.          Os2You remote software (following 10-19)  ______   400  __________
  1790.  
  1791.          Os2You remote software (following 20-)    ______   300  __________
  1792.  
  1793.          Os2You for Sysops (for BBS use only)      ______   250  __________
  1794.  
  1795.          Os2You/M2Zmodem file transfer option      ______   300  __________
  1796.  
  1797.          WinTerm Windows 3.0 terminal program      ______   300  __________
  1798.  
  1799.  
  1800.                                  Total                      SEK  __________
  1801.  
  1802.  
  1803.          All prices are in SEK (Swedish crown).  One USD is about 6 SEK.
  1804.          The price for Os2You is about $80 and $50 for M2Zmodem.
  1805.  
  1806.  
  1807.          If you pay with VISA or MasterCard please fill in the following:
  1808.  
  1809.  
  1810.          Cardholders name: ________________________________________
  1811.  
  1812.          Cardholders address: _____________________________________
  1813.  
  1814.          Card number: _____________________________________________
  1815.  
  1816.          Card validy until: _______________________________________
  1817.  
  1818.          Signature: _______________________________________________
  1819.  
  1820.  
  1821.  
  1822.          Send or FAX a copy of this invoice to:
  1823.  
  1824.          M Wahlgren Software Dev.
  1825.          Kransen 4E
  1826.          S-416 72  Gothenburg
  1827.          Sweden
  1828.          Fax: +46 31 196417
  1829.  
  1830.  
  1831. ΓòÉΓòÉΓòÉ 22. Planned enhancements ΓòÉΓòÉΓòÉ
  1832.  
  1833. Planned enhancements 
  1834.  
  1835.  The following is a list a enhancements planned in a future release.  It isn't 
  1836. sure that the next release of the program will include these enhancements 
  1837. though. 
  1838.  
  1839.  o SafeShell.  A menu program there you can install different programs, that 
  1840.    you can give different users access to. 
  1841.  
  1842.  o SafeCMD.  A CMD.EXE replacement, that has file and directory security 
  1843.    implemented. 
  1844.  
  1845.  o A BBS program, for writing/sending/reading mail, with file transfer 
  1846.    capabilities and much more, running under Os2You.  This program is meant to 
  1847.    be extremely easy to handle, and can be run over a LAN for internal 
  1848.    messaging purpose. 
  1849.  
  1850.  o X.25 support. 
  1851.  
  1852.  
  1853. ΓòÉΓòÉΓòÉ 23. Copyright notes ΓòÉΓòÉΓòÉ
  1854.  
  1855. Copyright notes 
  1856.  
  1857.  OS/2      is a trademark of IBM Corporation. 
  1858.  
  1859.  PS/2      is a registered trademark of IBM Corporation. 
  1860.  
  1861.  IBM       is a registered trademark of International Business Machines 
  1862.            Corporation. 
  1863.  
  1864.  DSZ       is a trademark of Omen Technology Incorporated. 
  1865.  
  1866.  386/SX    might be a trademark of Intel Corporation. 
  1867.  
  1868.  Novell    is a trademark of Novell Inc. 
  1869.  
  1870.  Microsoft is a trademark of Microsoft Corporation. 
  1871.  
  1872.  Hayes     is a trademark of Hayes Microcomputer Products. 
  1873.  
  1874.  
  1875. ΓòÉΓòÉΓòÉ 24. Release log ΓòÉΓòÉΓòÉ
  1876.  
  1877. Release log Bugs and improvements not described elsewhere are documented in 
  1878. this section. 
  1879.  
  1880.  1.0       First release 
  1881.  
  1882.  1.1       The program could terminate with a GP error when run on a PS/2 
  1883.            system.  The port-parameters was not correctly restored.  This is 
  1884.            now corrected. 
  1885.  
  1886.  1.2       Improvements 
  1887.  
  1888.  1.3       Improvements 
  1889.  
  1890.  1.4       Improvements 
  1891.  
  1892.  1.5       Bug, that made the program incompatible with some programs 
  1893.            (especially programs polling the keyboard) is fixed. 
  1894.  
  1895.  1.6       Improvements 
  1896.  
  1897.  1.7       Some scancodes adjusted to make the CTRL-key, Enter-key and some 
  1898.            other special keys more compatible with some programs.
  1899.  
  1900.             The command line syntax is altered. 
  1901.  
  1902.  1.8       LAN/Pipe operation fixed again.  Previous LanTerm2 didn't work due 
  1903.            to a serious compiler bug.
  1904.  
  1905.             The configuration file is opened in Deny Write mode for security 
  1906.            reasons.  This makes it impossible to modify the configuration file 
  1907.            during an session. 
  1908.  
  1909.  1.9       The Allow Task Switch option in the login table is now used to 
  1910.            disable the task switch and the Break-functions.
  1911.  
  1912.             If the -s option is used or Allow Task Switch option is set to no 
  1913.            in the user profile, the user won't be able to use the Esc-c, 
  1914.            Esc-Break sequences (to end the session abnormally).
  1915.  
  1916.             Now Break scancodes are also sent.
  1917.  
  1918.             Lanterm.EXE (LAN-operation for DOS workstations) are now included again.
  1919.  
  1920.             Better shutdown operation, when a program gets stuck, or user lost 
  1921.            carrier.  REXX-sessions are shutdown correctly.
  1922.  
  1923.             Terminal configurable in user table.
  1924.  
  1925.             The configuration file is optionally (configurable) opened in Deny 
  1926.            Read/Write mode. 
  1927.  
  1928.  1.91      Fix to get the program work with LAN Server 1.2 CSD 4093 and DOS 
  1929.            Requesters.  Also tested successfully using Novell server and remote 
  1930.            named pipes.
  1931.  
  1932.             LanBridge added, to run OS/2 LAN Requesters remote over LAN.
  1933.  
  1934.             If program can't be killed, when exiting the session, Os2You will 
  1935.            go back to login screen.  Next user will probably get confused, 
  1936.            because the previous program is still alive.
  1937.  
  1938.             -s (disable task list) is default when using MaxPipe parameter syntax.
  1939.  
  1940.             LanTerm and LanTerm2 programs are altered, to change the behaviour 
  1941.            of the Esc-key.  If the Esc-key in LanTerm(/2) is pressed the 
  1942.            program will send double Esc-codes making Os2You send one 
  1943.            Esc-sequence to the application.  If you press Shift-Esc in the 
  1944.            LanTerm(/2) program will send just one Esc-code, making Os2You to 
  1945.            wait for an Esc-sequence (or displaying the help screen). 
  1946.  
  1947.  2.0       Color attributes are now transfered to the remote screen, by using 
  1948.            ANSI color escape sequences.  It is default to use ANSI colors when 
  1949.            no terminal definition file or an old definition is loaded.  To 
  1950.            upgrade your old terminal definition files, select terminal 
  1951.            definition from the Os2You menu, and modify the ANSI color entry. 
  1952.            Your other definitions will be intact.
  1953.  
  1954.             The screen update handling is altogether rewritten.  In some 
  1955.            respects it is faster, but in some situations it might also be 
  1956.            slower than before.  The terminal does not need to wrap at end of 
  1957.            lines anymore. The program now supports different screen widthes and 
  1958.            heights.  The program assumes that you are running the application 
  1959.            in color mode (two bytes per character cell).  If this is not the 
  1960.            case, the program will transfer false attributes (converting 
  1961.            underline/highlights to colors).
  1962.  
  1963.             The -n option now allows Os2You to directly spawn different 
  1964.            sessions depending on the username.  The callback, shell, terminal 
  1965.            and switch parameters are used from the login table.
  1966.  
  1967.             The COM-buffers are flushed by reading all available characters, in 
  1968.            addition to a DosDevIOCtl call, as the DosDevIOCtl call didn't seem 
  1969.            to work in some networking environments.
  1970.  
  1971.             The option to strip control characters (0-31) and high order 
  1972.            characters (127-255) are added in the terminal definition file. The 
  1973.            default, if no terminal definition file or an old definition is 
  1974.            used, is to strip control characters but leave high order characters.
  1975.  
  1976.             LanTerm/2 (for OS/2) and LanTerm (for DOS) are modified to accept 
  1977.            COM-ports from the command line.  Both program can be started with 
  1978.            the syntax LanTerm <COM-port> <baudrate>.  The COM-port must have a 
  1979.            name beginning with COM, and for the DOS-version only COM1 and COM2 
  1980.            are valid.  LanTerm (for DOS) requires that ANSI.SYS is loaded in 
  1981.            your CONFIG.SYS file.  Both programs take advantage of the FIFO 
  1982.            buffered 16550 UART if available.
  1983.  
  1984.             LanTerm/2 and LanTerm now have Zmodem AUTO download/upload 
  1985.            capability. To transfer files between host and remote, just issue a 
  1986.            file transfer command on the host (use the Rz or Sz command files 
  1987.            and M2Zmodem), and the file transfer program will start on both host 
  1988.            and remote.  If you upload from remote to host, you will be asked 
  1989.            for a filename/pattern. LanTerm/2 uses M2Zmodem, and LanTerm uses 
  1990.            DSZ as file transfer programs, and these programs must be available 
  1991.            in the current directory or in a path. 
  1992.  
  1993.  2.1       Fixed bug that left shifted the remote screen one column in some situations.
  1994.  
  1995.             Modem commands now configurable and stored in file MODEM.CFG.
  1996.  
  1997.             Box draw characters and special characters are translated into 
  1998.            available look alike characters (codepage 437), when terminal 
  1999.            definition file says to filter characters between 127-255.
  2000.  
  2001.             Keyboard emulation much enhanced with correct scan codes.  Now 
  2002.            works with programs like CodeView (TM) and MSC PWB.
  2003.  
  2004.             Dos2You program altered to exit by sending a Ctrl-C (03H).  Program 
  2005.            now exits clean and returns to Os2You correctly. 
  2006.  
  2007.  2.2       DTR control added in modem commands.
  2008.  
  2009.             Fixed bug that sent garbage modem commands, when modem commands was 
  2010.            of zero length.
  2011.  
  2012.             LanRel program addedd, to let other programs temporarily suspend 
  2013.            Os2You HOST-mode, to let other communication programs use the same 
  2014.            port/modem, while Os2You is waiting for an incoming call. It is also 
  2015.            possible to use LanTerm or LanTerm2 to access the port for outgoing 
  2016.            traffic port Os2You is using, by running these programs with the 
  2017.            port request pipe name as a parameter.
  2018.  
  2019.             Os2You now also acts as asynchronous communication server.  If 
  2020.            Os2You is installed on a network, it is possible to connect to the 
  2021.            COM device Os2You uses, with Lanterm(2) programs, by starting these 
  2022.            program with the port request pipe name as a parameter. File 
  2023.            transfer doesn't work though.
  2024.  
  2025.             Cursor positioning works even if you don't run your original session.
  2026.  
  2027.             M2Zmodem would hang Os2You and COM-device on some systems (like 
  2028.            Comp. 386/SX 20 Mhz and MS-OS/2 1.21).  This wasn't fixed in the 
  2029.            preliminary release. 
  2030.  
  2031.  2.3       Changed to new compiler, version 3.01.
  2032.  
  2033.             In HOST mode, Os2You no longer needs to scan for the baudrate when 
  2034.            using Hayes-modems or other automatic modems.  Os2You instead uses 
  2035.            the response strings sent by the modem.  When using Hayes/Auto 
  2036.            modems, the DCD line can be permanently SET.
  2037.  
  2038.             In HOST mode, Os2You now optionally displays a file, selected from 
  2039.            the configuration menu.
  2040.  
  2041.             In HOST mode, Os2You now optionally logs events in a file, selected 
  2042.            from the configuration menu.
  2043.  
  2044.             Configuration menus now with help texts! 
  2045.  
  2046.  2.4       Minor modification in the character translation logic.
  2047.  
  2048.             Screen updates faster with TAB space expansion.
  2049.  
  2050.             M2Zmodem version 2.11 will now support file transfers via pipes as 
  2051.            well as asynchronous lines.  This level of M2Zmodem is also required 
  2052.            for PMTerm.
  2053.  
  2054.             Task switching now works with OS/2 2.0.
  2055.  
  2056.             PMTerm - A terminal program for PM to run Os2You is included. (only 
  2057.            to registered users)
  2058.  
  2059.             Os2You is now able to use the baudrates 38400, 57600 and 115200, 
  2060.            without additional support from device drivers.  The line IOPL=YES 
  2061.            or IOPL=SETBAUD must be added to your CONFIG.SYS file to enable this 
  2062.            feature.  (only to registered users)
  2063.  
  2064.             It is now possible to pass parameters from the Os2You login table 
  2065.            to the spawned program.  You can pass User name (with %n), password 
  2066.            (%p), callback number (%c) and terminal type (%t).
  2067.  
  2068.             Modem configuration file renamed MODEM.PRM to MODEM.CFG.
  2069.  
  2070.             Setup program rewritten for Presentation Manager, and now easier to 
  2071.            use with more logical screens and ready modem setups.  Setup is 
  2072.            automaticly invoked when Os2You is started without any parameters, 
  2073.            but can be run directly from the command line by typing SETUP too. 
  2074.            The modem definitions are only briefly tested. 
  2075.  
  2076.  2.5       Os2You now seems to work OK with OS/2 2.0 (beta drop 6.149).  The 
  2077.            previous version had some problems with the keyboard monitor locking 
  2078.            up the second time, a user logged on.  A bug in OS/2 2.0 I think.
  2079.  
  2080.             LanTerm (terminal emulator for DOS), now can be run in terminate 
  2081.            and stay resident (TSR) mode (80 kByte), allowing you to 
  2082.            concurrently use both a remote OS/2 session and the local DOS session.
  2083.  
  2084.             User ID's with no password, are treated differently.  Now any 
  2085.            password is accepted for such ID's.  Entered passwords are logged to disk.
  2086.  
  2087.             Os2You now disconnects named pipes when a session is closed.
  2088.  
  2089.             Os2You now supports redirection of printers.  A printer's data 
  2090.            stream can be redirected to the remote computer.  This requires that 
  2091.            the terminal program on the remote, is capable of handling this. 
  2092.            LanTerm, LanTerm2 and PMTerm are currently capable of this.
  2093.  
  2094.             User-ID's and passwords with spaces wouldn't work.  This is now fixed.
  2095.  
  2096.             LanTerm and LanTerm2 now accepts an initialization string.  This 
  2097.            could be used for automatic dial and/or to initialize the modem.
  2098.  
  2099.  2.51      Os2You would trap intermittently, directly after logon Fixed.
  2100.  
  2101.  2.6       Os2You now has a service function menu.  By pressing Esc-y during a 
  2102.            session, you can select chat-mode and do file transfers, using 
  2103.            Ymodem batch protocol.
  2104.  
  2105.             Os2You now terminates sessions better.  Before Os2You could hang if 
  2106.            a session couldn't be closed, when a user exits (or drops carrier). 
  2107.            Os2You also exits cleaner when running independent sessions 
  2108.  
  2109.             LanTerm, LanTerm2 and PMTerm now has scripting capabilities. 
  2110.            Scripting works as in M2Zmodem, except that ^ means CR and ~ means pause.
  2111.  
  2112.             In OS/2 2.0 the DOS-compatibility boxes can be accessed remotely, 
  2113.            with some restrictions.  The DOS box can no longer be accessed, 
  2114.            using OS/2 1.3 as the programs supporting this feature, is no longer 
  2115.            distributed with the package. If you already have the DOS_REDIR and 
  2116.            DOS2YOU programs, they will probably continue to work.  These files 
  2117.            can also be requested especially, when registering.
  2118.  
  2119.             The Task Switched is altered in design.  It now also allows switch 
  2120.            to DOS Full Screen sessions directly, if you are using OS/2 2.0.
  2121.  
  2122.             PMTerm (terminal program for PM) is now renamed to Terminal/2, 
  2123.            because the name PMTerm was already occupied.
  2124.  
  2125.             A Windows terminal emulator is now included.  Note that this comes 
  2126.            from an independent source, and requires separate registration. 
  2127.            WinTerm, Terminal/2 and LanTerm2 all have Ymodem-Batch protocols 
  2128.            included, and also a special AUTO Ymodem up/download facility, that 
  2129.            automaticly will invoke the file transfer protocol when Os2You 
  2130.            request it.  Current levels are 1.0 for WinTerm, 1.1 for Terminal/2 
  2131.            and 2.6 for LanTerm2.  These levels are required for Os2You version 2.6.
  2132.  
  2133.             The inactivity timeout timer, would trigger if the system time was 
  2134.            changed. This is fixed.
  2135.  
  2136.             Improved screen updates in some cases.
  2137.  
  2138.  2.7       The service functions menu is only available if the user has task 
  2139.            switch privelige.
  2140.  
  2141.             The terminal emulation profiles, now have an option to escape (but 
  2142.            still transfer) control characters.  Some "hard to print" characters 
  2143.            can also be displayed using this feature.
  2144.  
  2145.             Cursor update delay for task switched sessions, is now configurable.
  2146.  
  2147.             Os2You running OS/2 2.0 (304e) would trap when exiting, if the 
  2148.            physical keyboard is under high load.  Os2You running OS/2 1.3 would 
  2149.            hang when exiting, if the keyboard buffer was full at that time.  Fixed.
  2150.  
  2151.             Switching to tasks on the second "page", wouldn't work.  This is fixed.
  2152.  
  2153.             File transfer with the built in file transfer protocol fixed.
  2154.  
  2155.             Special care was taken to terminate REXX batches correctly 
  2156.            previously.  This caused some problems with other programs, and is 
  2157.            therefore removed.  Other applications are now terminating better 
  2158.  
  2159.             Access to the MVDM (DOS-boxes) in OS/2 2.0 is now improved.  It is 
  2160.            now possible to emulate most character sequences in the DOS-box, 
  2161.            like function and arrow keys.  This is accomplished with the 
  2162.            KBFILTER utility that must be run in the DOS-box before function 
  2163.            keys will begin to work (you could invoke this program in your 
  2164.            AUTOEXEC.BAT file, it will take a minimum of memory and interfere 
  2165.            very little with your usual work).
  2166.  
  2167.  
  2168. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  2169.  
  2170. All strings sent to the modem may contain the following special control 
  2171. characters: 
  2172.  
  2173.  ^ (5E)    CR 
  2174.  
  2175.  ~ (7E)    1s pause 
  2176.  
  2177.  ╨ä (F2)    DTR low 
  2178.  
  2179.  ╤ö (F3)    DTR high 
  2180.  
  2181.  ; (3B)    Comment 
  2182.  
  2183.  
  2184. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  2185.  
  2186. The following symbolic parameters are valid: 
  2187.  
  2188.  %n        User name 
  2189.  
  2190.  %t        Terminal 
  2191.  
  2192.  %p        Password 
  2193.  
  2194.  %c        Callback 
  2195.  
  2196.  %%        % (percent sign) 
  2197.  
  2198.  Example: BBS.EXE COM1 %n %p %%p
  2199.  
  2200.   If the user is Mikael Wahlgren and password secret the example would execute 
  2201.  the program BBS.EXE with the parameters COM1 Mikael_Wahlgren secret %p 
  2202.  
  2203.  
  2204. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  2205.  
  2206. This entry expects an array of hex values.  You should enter hex values between 
  2207. 00 and F, all separated by space.
  2208.  
  2209.  Example: 1B 41 01 FE